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内 容 简 介 
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关于 本 书 


随 着 3G 和 触摸 屏 的 技术 发 展 ,移动 智能 终端 , 即 智能 手机 和 平板 电脑 ,已 
经 成 为 人 们 日 常 通信 和 信息 处 理 的 工具 ,移动 互联 网 正在 改变 人 们 的 交流 和 
生活 方式 。 作 为 移动 智能 终端 两 大 操作 系统 之 一 ,Android 的 影响 力 已 经 渗透 
到 移动 领域 以 外 ,特别 是 物 联网 和 电视 等 平台 ,Android 应 用 程序 也 由 个 人 应 
用 逐步 向 企业 应 用 扩展 。 掌 握 Android 技术 的 人 才 就 业 前 景 非常 广泛 。 

我 们 编写 本 书 主要 有 两 个 目的 : 

全 面 系统 地 提供 Android 开发 的 基础 知识 ,基于 Android Studio 开发 环 
境 提供 编程 示例 。 在 本 书 的 编写 中 把 Android 的 基础 知识 ,与 自己 的 教学 经 
验 和 学 习 的 体会 结合 起 来 ,希望 能 够 引导 Andorid 技术 学 习 者 快速 入 门 , 系 
统 地 掌握 Android 编程 技术 。 

由 于 目前 Android 技术 更 新 很 快 ,本 书 内 容 中 的 概念 和 原理 主要 参考 
Android 的 官方 网 站 ,尽量 做 到 既 准确 又 易于 理解 ,代码 示例 均 通 过 实际 调 
试 ,可 运行 。 

本 书 主要 围绕 Android 技术 ,讲述 如 何 利用 Android 相关 技术 ,开发 移 
动 终端 的 互联 网 应 用 程序 。 全 书 共 分 为 10 章 。 

第 1 章 概述 使 用 Android 技术 在 移动 终端 开发 的 基础 知识 ,包括 
Android 的 基本 常识 和 技术 框架 ,并 介绍 如 何 搭建 Android 开发 环境 
Android Studio 和 Android 应 用 程序 项 目的 结构 。 

第 2 章 主要 介绍 Android 的 四 大 基础 组 件 之 一 Activity\ 布 局 和 资源 的 
概念 ,介绍 如 何 使 用 Android 的 Activity 和 布局 管理 器 来 设计 移动 终端 的 用 
户 图 形 界面 。 

第 3 章 主要 介绍 三 部 分 内 容 。 首 先 介 绍 Fragment 的 概念 ,Fragment 的 
生命 周期 以 及 使 用 Fragment 静态 创建 和 动态 创建 用 户 界面 的 具体 步骤 和 
代码 ;第 二 部 分 主要 介绍 Android 用 户 界面 的 事件 处 理 机 制 ,图 形 界面 中 的 
常用 视图 控件 如 何 使 用 及 如 何 进行 事件 处 理 ,其 中 包括 按钮 控件 中 的 
Button、RadioButton、Checkbox 和 ToggleButton, Toast 控件 ,以 及 文本 控 
件 中 的 TextView 和 EditText; 最 后 使 用 例子 说 明了 如 何 对 界面 进行 处 理 ， 
使 其 显示 效果 多 样 化 。 
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第 4 章 主 要 介绍 了 Android 应 用 程序 的 浏览 模式 。 从 Android 3. 0 开始 ,Android £ 
统 的 应 用 浏览 模式 发 生 了 较 大 的 改变 ,引入 了 向 上 和 返回 的 设计 原则 ,并 且 提 供 了 相应 的 
设计 组 件 ,其 中 包含 菜单 和 动作 条 等 。 本 章 主要 介绍 菜单 模式 和 动作 条 模式 的 实现 。 

第 5 章 主要 介绍 Android 系统 的 应 用 程序 之 间 发 送 和 接收 消息 的 机 制 。 介 绍 
Android 实现 发 送 和 接收 消息 的 Intent、BroadcastReceiver 组 件 和 Notification 组 件 的 概 
念 .用 途 和 实现 方法 。 

第 6 章 主要 介绍 Android 系统 的 多 任务 机 制 、. 主 线程 的 概念 和 实现 多 任务 的 原理 ,以 
及 在 Androd 系统 中 如 何 使 用 handler 或 AsyncTask 实现 应 用 程序 的 多 任务 。 在 多 任务 
的 基础 上 ,本 章 的 另 一 部 分 介绍 Android 的 四 大 组 件 之 一 Service 的 概念 和 基本 知识 ,以 
及 在 应 用 程序 中 实现 Service 的 两 种 方式 。 

第 7 章 主要 介绍 Android 系统 实现 应 用 程序 数据 存储 的 机 制 , 包 括 用 户 偏好 的 存 取 、 
文件 的 读 取 与 保存 和 SQLite 数据 库 的 创建 与 操作 。 

第 8 章 主 要 介绍 Android 的 四 大 组 件 之 一 ContentProvider 的 概念 和 相关 知识 ,以 及 
如 何 创建 和 使 用 ContentProvider, 如何 通 过 数据 绑 定 ,使 用 适配器 .视图 对 象 和 SQLite 
数据 库 的 ContentProvider 实现 数据 加 载 , 最 终 向 用 户 显示 数据 。 

第 9 章 主要 介绍 Android 有 关 触 摸 屏 的 应 用 程序 开发 。 包 括 触摸 事件 的 定义 、 触 摸 
事件 的 传递 机 制 、 触 摸 点 移动 的 速率 跟踪 、 多 点 触 控 、 手 势 识 别 和 拖 放 处 理 等 。 

第 10 章 有 两 个 部 分 。 第 一 部 分 主要 介绍 Android 应 用 程序 如 何 通 过 GPS 和 
Android 网 络 位 置 提 供 器 ,获取 位 置信 息 , 实 现 定 位 服务 ;第 二 部 分 主要 介绍 Android 应 
用 程序 如 何 使 用 Google 公司 提供 的 Google Maps API, 实 现 应 用 程序 中 的 Goolge 地 图 
的 功能 。 

本 书 基 本 囊括 了 Android 技术 体系 中 的 基础 部 分 ,并 使 用 短小 易 懂 的 例子 详细 说 明 
了 如 何 应 用 。 本 书 的 不 足 之 处 在 于 ,由 于 时 间 和 篇 幅 的 原因 ,本 书 只 是 编写 了 Android 技 
术 中 最 基础 的 部 分 ,Android 技术 中 关于 网 络 互联 、 动 画 、 游 戏 、 服 务 器 和 其 他 更 深层 次 的 
应 用 等 都 没有 涉及 ,不 能 全 面 覆盖 Android 技术 ,还 请 读者 谅解 。 并 且 , 由 于 水 平 的 原因 ， 
在 本 书 的 编写 过 程 中 可 能 存在 一 些 对 Android 技术 及 移动 互联 网 技术 介绍 不 全 面 或 者 
表述 邪 漏 的 地 方 , 敬 请 读者 批评 指正 。 


读者 对 象 





本 书 是 Android 技术 入 门 的 基础 类 书籍 ,通过 本 书 的 学 习 读者 可 以 牢固 掌握 
Android 编程 技术 的 基本 概念 ,原理 和 编程 方法 ,能 够 进行 应 用 程序 的 实际 开发 。 

本 书 适 合 对 Java 编程 有 一 定 基础 、 希 望 掌 握 Android 程序 设计 技术 的 读者 ,也 适合 
作为 高 等 学 校 计算 机 专业 的 教材 ,还 可 作为 Android 程序 设计 者 的 培训 教材 。 
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第 4 == 


Android 开发 基础 


Android 是 一 种 以 Linux 为 基础 的 开放 源 代码 操作 系统 ,主要 使 用 于 便携 设备 。 目 
前 尚未 有 统一 中 文 名称 , 中 国 大 陆地 区 大 多 数 人 使 用 “ 安 卓 ”或 “ 安 致 ”"。Android RER 
统 最 初 由 Andy Rubin 开发 ,主要 用 于 支持 手机 。2005 年 由 Google 收购 注资 ,并 组 建 开 
放手 机 联盟 ,进行 开发 改良 ,逐渐 扩展 到 平板 电脑 及 其 他 领域 。2008 年 ,在 Google 1/0 
大 会 上 ,谷歌 提出 了 Android HAL 架构 图 ,并 在 同年 9 月 正式 发 布 了 Android 1.0 系统 ， 
这 也 是 Android 系统 最 早 的 版 本 。 到 目前 为 止 ,最 新 的 正式 版 本 是 2016 年 8 月 发 布 的 
Android 7. 0 Nougat( 牛 轧 糖 ) 。 截 止 到 2016 年 4 月 的 前 三 个 月 数据 统计 ,Android 系统 
的 全 球 市 场 份额 已 经 达到 了 76% ,在 美国 市 场 该 期 间 内 的 份额 为 67. 6% ,在 中 国 大 陆 城 
市 地 区 该 期 间 内 的 市 场 份额 为 78.8%。 目 前 Android 的 主要 竞争 对 手 是 Apple 的 IOS. 


1.1 Android 入 门 


Android 系统 是 基于 Linux 平台 的 智能 手机 操作 系统 。Android 是 一 个 开源 的 平台 ， 
它 由 操作 系统 、 中 间 件 、 用 户 界面 和 应 用 软件 等 部 分 组 成 。 

Android 系统 采用 软件 堆 层 (Software Stack, 又 名 软件 三 层 ) 的 系统 架构 ,由 多 个 程 
序 组 合 来 完成 一 个 共同 的 任务 。Android 的 系统 架构 主要 分 为 三 个 层次 : 底层 以 Linux 
内 核 为 基础 ,由 C 语言 开发 ,是 移动 设备 的 操作 系统 ,只 提供 基本 功能 ;中 间 层 包括 函数 
库 (Library) 和 虚拟 机 (Virtual Machine) ,由 C++ 开发 ;最 上 层 是 各 种 应 用 软件 组 成 ,包括 
通话 程序 .短信 程序 和 游戏 等 。 

Android 系统 作为 一 个 移动 开放 平台 ,提供 了 与 Apple 移动 系统 不 同 的 生态 环境 。 
任何 手机 厂商 都 可 以 免费 使 用 Android 系统 来 定制 自己 的 产品 ,而 且 Android 系统 提供 
了 标准 的 SDK ,应 用 软件 可 以 由 第 三 方 开发 者 独立 完成 ,目前 应 用 的 开发 语言 使 用 Java, 


1.1.1 Android 简介 


从 Andoird 1. 5 版 本 开始 ,Android 选择 使 用 甜点 名 称 作为 系统 版 本 的 代号 ,其 版 本 
的 名 称 分 别 为 纸杯 蛋糕 (Cupcake) 、 甜 甜 圈 (Donut) 、 松 饼 (Eclair) 、 冻 酸奶 (Froyo) 、 姜 饼 
(Gingerbread) , $ # ( Honeycomb) 、 冰 激 凌 三 明治 (Ice Cream Sandwich)、 果 冻 豆 (Jelly 
Bean) ,巧克力 (KitKat) , Ë Ë pë (Lollipop) 、 棉 花 糖 (Marshmallow)、 牛 轧 糖 (Nougat)。 
而 且 版 本 名 称 的 英文 名 首 字母 按照 字母 的 顺序 ,从 C 开始 到 N. 目前 最 新 的 版 本 
Android 7. 0 ( API level 24) Nougat 的 下 一 个 版 本 ,应 该 是 以 O 作为 首 字 母 的 甜点 名 称 。 
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表 1.1 是 Android 各 版 本 对 应 的 名 称 和 API Level 所 对 应 的 市 场 份额 ,可 以 在 程序 开发 






































和 发 布 时 作为 参考 。 
表 1.1 Android 的 各 个 版 本 
版 本 名 称 API Level 比例 
£2 Froyo 8 0.1% 
2.3 Gingerbread 10 1.7% 
4.0 Ice Cream Sandwich 15 1.6% 
4.1 16 6.0% 
4.2 Jelly Bean 17 8.3% 
4.3 18 2.4% 
4.4 KitKat 19 29.2% 
5.0 21 14.1% 
一 Lollipop 
8.1 22 21.4% 
6.0 Marshmallow 23 15.2% 
7:0 Nougat 24 0 











Google 以 7 天 为 一 个 周期 对 Android 版 本 的 使 用 情况 进行 统计 , 表 1. 1 中 的 比例 表 
示 了 2016 年 8 月 1 日 为 止 ,Android 设备 中 的 不 同 版 本 分 布 比例 。 根 据 表 1. 1 的 数据 ， 
1.1 显示 了 目前 版 本 的 使 用 分 布 。 从 图 1. 1 可 以 看 出 ,目前 手机 上 用 得 最 多 的 版 本 为 
4.4 的 KitKat #l 5. 0,5. 1 BJ Lollipop, f# Marshmallow 已 经 占有 了 不 少 的 份额 ,如 果 要 
发 布 应 用 ,需要 选择 适合 的 Android 版 本 ,方便 在 不 同 的 版 本 中 支持 该 应 用 。 


Froyo Gingerbread Ice Cream 


Sandwich 








Marshmallow = 


Jelly Bean 


Lollipop 
KitKat 


图 1.1 Android 版 本 分 布 


1.1.2 Android 技术 架构 


Android 技术 架构 见 图 1. 2。Android 技术 架构 由 五 部 分 组 成 ,从 顶层 到 底层 ,依次 
是 Application, Android Framework, Native Libraries, Android Runtime ( ART), 
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Hardware Abstraction Layer( HAL). Linux Kernel。 如 果 是 Android 应 用 开发 者 ,只 需 
要 了 解 Application 和 Android Framework 上 面 两 个 层次 ;如 果 是 风 入 式 和 硬件 移植 的 
开发 者 ,还 需要 了 解 Native Libraries. Android Runtime (ART)、Hardware Abstraction 
Layer (HAL) 和 Linux Kernel 这 几 个 部 分 。 





Application 








Android Framework 




















| Native Libraries Android Runtime (ART) 


Hardware Abstraction Layer (HAL) 











Linux Kernel 


图 1.2 Android 技术 架构 


1. Application 

Android 配置 一 个 核心 应 用 程序 集合 ,包括 电子 邮件 客户 端 \SMS 程序 日 历 、 地 图 、 
浏览 器 、 联 系 人 、 照 相机 、E-mail、 时 钟 , 拨 号 和 其 他 设置 。 所 有 应 用 程序 都 是 用 Java 编程 
语言 写 的 。 用 户 自己 开发 的 App 应 用 也 在 这 个 层次 。 

2. Android Framework 

Android 提供 开放 的 应 用 框架 Android Framework, 应 用 开发 者 可 以 方便 地 设计 丰 
富 和 新 颖 的 应 用 程序 。 通 过 应 用 框架 ,开发 者 能 够 自由 地 利用 设备 硬件 、 使 用 访问 位 置信 
息 、 运 行 后 台 服 务 .设置 闹钟 ,并 且 向 状态 栏 添加 通知 等 功能 。 由 于 这 个 应 用 开发 框架 是 
完全 开放 的 ,应 用 开发 者 能 够 使 用 框架 的 核心 功能 。 

设计 应 用 框架 的 目的 在 于 方便 组 件 的 重用 ,简化 应 用 程序 的 开发 ,而且 应 用 程序 都 可 
以 发 布 和 使 用 应 用 框架 中 的 功能 。 应 用 框架 主要 是 由 下 面 的 功能 组 成 的 : 

。 视图 系统 (View System) 一 一 包括 丰富 的 、 可 扩展 的 视图 集合 ,可 用 于 构建 一 个 应 
用 程序 ,包括 列表 、 网 格 ,文本 框 ,按钮 ,甚至 是 内 典 的 网 页 浏览 器 。 
内 容 提供 者 (ContentProviders) 使 应 用 程序 能 访问 其 他 应 用 程序 (如 通讯 录 ) 
的 数据 ,或 共享 自己 的 数据 。 
管理 器 (Manager) 包括 许多 管理 器 。 其 中 资源 管理 器 (Resource Manager) 为 
应 用 程序 提供 可 访问 的 非 代码 资源 ,如 本 地 化 字符 串 、 图 形 和 布局 文件 等 ;通知 管 
理 器 (Notification Manager) 支 持 所 有 的 应 用 程序 能 在 状态 栏 显 示 自 定义 警告 ; 
动 管理 器 (Activity Manager) 管 理 用 户 界 面 应 用 程序 的 生命 周期 ,提供 通用 的 导 
航 回 退 功能 ;位 置 管理 器 (Location Manager) 支持 移动 设备 上 基于 位 置 和 地 图 的 
应 用 ,可 以 和 Google Location Services API 配合 使 用 ,实现 更 强大 的 框架 。 

3. Native Libraries 

Native Libraries( 本 地 库 ) 是 由 Android 提供 的 一 系列 本 地 头 文 件 和 共享 库 文件 ,应 
用 程序 通过 Android Framework 调用 。Native Libraries 支持 使 用 硬件 传感器 ,访问 存储 
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器 处 理 用 户 输入 、 配 置信 息 设 置 等 功能 。 随 着 Android 版 本 和 Android API Level 的 不 
断 更 新 ,Native Libraries 的 功能 逐渐 增长 。 到 目前 为 止 ,包括 C/C++ E ZLib 压缩 库 、 动 
ABERE RAR 3D 图 形 加 速 标准 OpenGL ES 库 、 分 配 和 管理 OpenGL ES 的 EGL 库 、 
嵌入 式 音频 加 速 标准 OpenSL ES E FreeType 位 图 和 矢量 字体 处 理 库 、 强 大 而 轻 量 级 的 
关系 数据 库 引 擎 SQLite、WebKit 和 OpenMAX AL 等 库 。 

4. Android Runtime 

Android Runtime(ART) 包 括 核 心 库 .ART 和 Dalvik 虚拟 机 。 

从 Android 4. 4 开始 ,Adnroid 就 推出 了 新 的 Android 运行 时 (ART) ,替代 之 前 版 本 
的 Dalvik, ART 的 功能 是 管理 和 运行 Android 应 用 程序 和 Android 的 一 部 分 系统 服务 。 
与 Dalvik 相 比 ,ART 提供 了 许多 新 的 功能 ,来 改善 Android 平台 和 应 用 的 性 能 。ART 
和 它 的 前 身 Dalvik 都 是 专门 为 Android 项 目 创 建 的 ,ART 遵循 Dalvik 可 执行 格式 和 
Dex 字 节 码 规范 。 

ART 和 Dalvik 运行 Dex 字 节 码 时 是 兼容 的 ,因此 基于 Dalvik 开发 的 应 用 也 可 以 在 
ART 上 运行。 但 有 时 候 , 基 于 Dalvik 的 技术 无 法 在 ART 上 实现 。 

5. Hardware Abstraction Layer 

硬件 抽象 层 (Hardware Abstraction Layer, HAL) 为 硬件 厂商 定义 了 一 个 标准 接口 ， 
Android 系统 通过 这 个 标准 接口 使 用 硬件 实现 的 功能 ,底层 的 硬件 驱动 实现 对 于 Android 
系统 透明 。 也 就 是 说 ,Android 的 上 层 应 用 只 需 调 用 这 些 标准 接口 来 实现 软件 的 功能 ,不 
必 了 解 具体 是 哪 家 厂商 的 产品 ,如 何 实现 。 

HAL 使 得 Android 系统 的 上 层 软件 功能 与 硬件 实现 隔离 开 , 不 同 硬件 的 支持 ,不 会 
影响 也 不 需要 修改 上 层 软 件 系统 。 

当然 ,针对 不 同 的 厂商 产品 ,需要 开发 对 应 的 HAL。HAL 的 实现 部 分 以 . so 的 文件 
模式 存储 在 共享 库 模块 中 。 

6. Linux Kernel 

Android 的 Linux Kernel 提供 操作 系统 的 核心 系统 服务 ,包括 安全 管理 内存 管理 、 
进程 管理 .网络 堆栈 、 电 源 管理 和 驱动 模型 等 。 例 如 声音 显示、 相机、 蓝牙 .Wi-Fi 等 设备 
的 驱动 ,都 在 这 一 层 实现 。 


1.2 Android Studio 环境 搭建 


在 进行 Android 应 用 程序 开发 之 前 ,需要 搭建 Android 应 用 程序 开发 环境 。 本 书 中 
采用 开源 的 Android Studio 2. 1. 2 集成 开发 环境 开发 工具 。 有 关 Eclipse 平台 开发 
Android 的 开发 环境 搭建 ,参看 附录 A。 

Android Studio 是 Android 开发 的 官方 集成 开发 环境 (IDE) ,提供 开发 Android App 
所 需要 的 各 种 支持 工具 和 软件 包 。 安 装 完 的 Android Studio, 具 有 下 面 的 功能 : 

e IntelliJ IDE+ Android Studio plugin; 

。 Android SDK 工具 包 ; 

。 Android 平台 工具 ; 
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。 Android 开发 平台 ; 

。 包含 Google Play Service、 带 有 Android 系统 图 像 的 Android 模拟 器 。 

由 于 Android Studio 把 Android 应 用 程序 开发 所 需 的 运行 环境 、 库 .开发 工具 和 界面 
都 集成 为 一 个 包 , 因此 安装 比较 简单 。 具 体 安装 过 程 见 1. 2. 1 节 。 如 果 已 经 熟悉 
Android Studio 开发 环境 的 安装 ,可 以 跳 过 1.2 节 , 直 接 阅 读 后 面 的 内 容 。 

Android Studio 针对 Windows. Mac. Linux 不 同 的 操作 系统 ,提供 相应 的 安装 包 。 
具体 的 下 载 网 址 为 https://developer. android. com/studio/index. html, 

在 下 载 完 成 Android Studio 安装 包 之 后 ,首先 需要 确认 操作 系统 已 经 安装 了 JDK, 
并 且 版 本 在 1. 8 以 上 。 下 面 针 对 不 同 操作 系统 ,介绍 Android Studio 具体 的 安装 步骤。 


1.2.1 基于 Windows 的 安装 


具体 的 安装 步骤 如 下 : 

(1) 打开 命令 行 窗口 ,输入 javac -version 命令 ,如 果 JDK 不 存在 ,或 JDK 的 版 本 低 
于 1. 8, 从 网 址 http://www. oracle. com/technetwork/java/javase/ downloads/ jdk8- 
downloads-2133151. html 下 载 Java SE Development Kit 8 ,并 进行 安装 。 

(2) 运行 所 下 载 的 Android Studio 安装 包 . exe 文件 。 

(3) 根据 安装 提示 安装 Android Studio 和 SDK 工具 。 

(4) 在 安装 完成 界面 ,选中 Start Android Studio 选项 , 单 击 Finish 按钮 ,启动 
Android Studio 设置 ,进行 初始 设置 。 

(5) 根据 需要 选择 Android Studio 预定 的 设置 ,或 者 选择 自 定 制 的 设置 ,然后 单 击 
OK 按钮 , 见 图 1. 3。 建 议 选 择 默认 选项 ,即位 于 下 面 的 Android Studio 预定 设置 选项 , 继 
续 下 面 的 配置 。 这 个 过 程 包括 下 载 Android 的 组 件 和 工具 包 ,并 进行 安装 ,需要 的 时 间 会 
有 点 长 ,请 耐心 等 待 ,直到 完成 配置 过 程 ,出 现 Android Studio 启动 界面 , 见 图 1. 4。 关 闭 
Android Studio 启动 界面 ,就 完成 了 安装 。 





® Complete Installation x 


You can import your settings from a previous version of Studio. 








Specify config folder or installation home of the previous version of Studio: 








(@ I do not have a previous version of Studio or I do not want to import my settings 





Ok 














1.3 配置 选择 


(6) 设置 Windows 系统 环境 变量 。 注 意 ,在 某 些 Windows 系统 中 ,Android Studio 
安装 脚本 找 不 到 JDK 的 路 径 ,如 果 遇 到 这 种 情况 ,需要 在 环境 变量 中 设置 JDK 路 径 。 具 
体操 作 如 下 : 选择 Start>Computer>System Properties>Advanced System Properties, 
然后 选择 Advanced— Environment Variables ,增加 一 个 新 的 系统 变量 JAVA_HOME 指 
定 JDK 路 径 , 例 如 ,C:\Program Files\Java\jdk1. 8.0_77。 

到 此 ,基于 Windows 的 Android Studio 安装 完成 ,下 一 步 可 以 进行 创建 Android 项 
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35% Start a new Android Studio project 

E Open an existing Android Studio project 
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LÝ Import project (Eclipse ADT, Gradle, etc.) 


LÝ Import an Android code sample 
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Æ 1.4 Android Studio 启动 界面 
目的 工作 了 。 
1.2.2 基于 Mac 的 安装 


具体 的 安装 步骤 如 下 : 
(1) 打开 命令 行 窗口 ,输入 javac -version 命令 ,如 果 JDK 不 存在 ,或 JDK 的 版 本 低 
于 1. 8, 从 网 址 http://www. oracle. com/technetwork/java/javase/downloads/jdk8- 
downloads-2133151. html 下 载 Java SE Development Kit 8 ,并 进行 安装 , 见 图 1.5. 
(2) 运行 所 下 载 的 Android Studio DMG w 
文件 。 ° 
(3) 把 Android Studio 拖 电 到 应 用 Application And roid 
文件 夹 ,然后 运行 Android Studio, DIUAYIO 


(4) 自己 根据 需要 选择 Android Studio 预定 
的 设置 ,或 者 选择 自 定制 的 设置 ,然后 单 击 OK Osm 





按钮 。 

(5) 根据 Android Studio 的 设置 提示 ,完成 包 
括 下 载 Android SDK 组 件 等 在 内 的 其 余 的 设置 。 图 1.5 安装 基于 Mac 的 

安装 过 程 中 的 一 些 细节 ,可 以 参考 Windows El 
安装 的 过 程 。 到 此 ,基于 Mac 的 Android Studio 安装 完成 ,下 一 步 可 以 进行 创建 Android 
项 目的 工作 了 。 
1.2.3 基于 Linux 的 安装 

具体 的 安装 步骤 如 下 : 


(1) 打开 命令 行 窗口 ,输入 javac -version 命令 ,如 果 JDK 不 存在 ,或 JDK 的 版 本 低 
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于 1. 8, 从 网 址 http://www. oracle. com/technetwork/java/javase/downloads/ jdk8- 
downloads-2133151. html 下 载 Java SE Development Kit 8 ,并 进行 安装 。 

(2) 在 合适 的 目录 下 ,例如 /usr/local 目录 ,将 所 下 载 的 Android Studio 安装 包 . zip 
文件 解压 缩 。 

(3) 运行 Android Studio, 打开 Terminal, 进入 android-studio/bin/ 目 录 , 执行 
studio. sh, 见 图 1. 6。 建 议 把 android-studio/bin/ 的 路 径 加 入 PATH 环境 变量 ,以 便 在 任 
何 目录 下 都 可 以 启动 Android Studio。 





图 1.6 Linux Terminal 中 的 命令 


(4) 自己 根据 需要 选择 Android Studio 预定 的 设置 ,或 者 选择 自 定制 的 设置 ,然后 单 
击 OK 按钮 。 

(5) 根据 Android Studio 的 设置 提示 ,完成 包括 下 载 Android SDK 组 件 等 在 内 的 其 
余 的 设置 。 

(6) 安装 过 程 中 的 一 些 细节 ,可 以 参考 Windows 安装 的 过 程 。 到 此 ,基于 Linux 的 
Android Studio 安装 完成 ,下 一 步 可 以 进行 创建 Android 项 目的 工作 了 。 


1.3 第 一 个 Android 应 用 程序 


1.3.1 创建 Android 项 目 


在 完成 了 Android 开发 环境 的 安装 和 配置 后 ,就 可 以 使 用 Android Studio 开始 开发 
Android 应 用 程序 了 。 下 面 介绍 第 一 个 Android 应 用 程序 Hello Mobile World 
的 开发 和 运行 过 程 , 它 的 功能 是 在 界面 上 显示 “Hello World” 的 字符 。 

第 一 次 编写 Android 应 用 程序 需要 以 下 四 个 步 又 : 

。 创建 一 个 新 的 Android 项 目 。 

。 运行 应 用 程序 。 

° 定义 简单 的 用 户 界面 。 

。 启动 男 一 个 Activity. 

(1) 在 Windows 下 运行 Android Studio ,出 现 图 1.7 所 示 的 Android Studio 启动 界 
面 后 ,选择 第 一 项 Start a new Android Studio project。 

(2) 在 新 项 目的 配置 界面 ,填写 Application name、Company Domain 和 Project 
location 对 应 的 文本 框 , 见 图 1. 8。 
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@ Welcome to Android Studio 


Android Studio 
Version 2 1.2 
J% Start a new Android Studio project 
D Open an existing Android Studio project 
$ Check out project from Version Control + 
DÝ Import project (Eclipse ADT, Gradle, etc.) 


LY Import an Android code sample 








3# Configure ~ Get Help + 





图 1.7 Android Studio 启动 界面 


New Project 





Configure your new project 





Application name: [ HelloWorld ] 


Company Domain: | cn.edu.uibe.id 


Package name: ituibe.edu.cn.helloworld Edit 
T 
==] REN [== [= ) 


图 1.8 项 目 配 置 界 面 





Project location: [Hi\2016\Androidprojects\HelloWorld 




















其 中 ,应 用 名 称 Application name 指 计 划 要 开发 的 App 名 称 , 这 里 的 App 名 称 为 
“HelloWorld”; 公司 域名 Company Domain 会 体现 在 App 的 Java 包 的 配置 上 ,Package 
的 名 称 刚好 与 其 相反 ,并 反 向 对 应 Java 源 代 码 存储 的 目录 ;项 目 位 置 Project location 是 
指 整个 项 目 所 在 的 路 径 , 可 以 通过 文本 框 后 面 的 按钮 ,在 计算 机 中 选择 合适 的 存储 位 置 。 

(3) 在 选择 Android 运行 的 设备 的 界面 上 ,选择 Phone and Tablet 复 选 框 ,让 App 的 
运行 环境 设置 为 手机 和 平板 电脑 , 见 图 1.9. 

如 果 在 后 面 的 开发 中 ,要 开发 可 穿戴 设备 .电视 .音频 和 眼镜 方面 的 应 用 ,可 以 根据 需 
要 选择 对 应 的 复 选 框 ,来 运行 和 调试 App。 

(4) 在 Add an Activity to Mobile 界面 ,选择 默认 选项 Empty Activity, 单 击 Next 按 
钮 。 图 形 用 户 界面 是 通过 类 Activity 的 子 类 来 实现 的 ,这 些 子 类 统称 为 Activities。 
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x Target Android Devices 


Select the form factors your app will run on 
Different platforms may require separate SDKs 


Phone and Tablet 





Minimum SDK. [API 15: Android 40.3 (iceCreamSandwich) B 
Lower API levels target more devices, but have fewer features available. 





By targeting API 15 and later, your app will run on approximately 97.4% of the devices 
that are active on the Google Play Store. 














Help me choose 

C Wear 

Minimum SDK. [API 21: Android 5.0 (Lollipop) B 
Ow 

Minimum SDK. [API 21: Android 5.0 (Lollipop) B 
C Android Auto 
C Glass 

Minimum SDK. [Glass Development Kit Preview (API 19) B 








[sea] WR | ss | [ | 
图 1.9 选择 Android 运行 的 设备 








(5) 在 Activity 配置 界面 ,填写 Activity Name, Layout Name 对 应 的 文本 框 , 见 图 1. 10。 








Creates a new empty activity 





Activity Name: | MainActivity| ] 
Generate Layout File 








Layout Name: | activiy_main 


Empty Activity 


The name of the activity class to create 


Previous | | Next | [| cas | EZE 





图 1.10 新 Activity 配置 界面 


其 中 , Activity Name 对 应 Java 源 代码 中 Activity 子 类 的 名 称 ; Layout Name 指 
XML 布局 文件 的 名 称 , 也 就 是 说 ,Android 系统 可 以 通过 XML 文件 ,设置 Android 手机 
和 平板 电脑 的 用 户 界面 具体 有 哪些 组 件 , 如 何 显示 。 在 这 里 ,选用 Android Studio 默认 的 
名 称 。 

(6) 单 击 Finish 按钮 ,完成 Android Studio 新 项 目 创建 的 设置 ,就 可 以 看 到 Android 
Studio 开发 界面 了 。 

(7) 关闭 提示 对 话 框 , 单 击 开发 界面 左边 界 的 Project 标签 ,打开 Project 的 内 容 , 在 
左边 的 窗口 可 以 看 到 刚才 所 创建 项 目的 目录 结构 。 展 开 相 应 的 目录 ,双击 java 目录 下 的 





`e 基于 Androd 平台 的 移动 互联 网 应 用 开发 (第 版 ) 


MainActivity, 以 及 res/layout 目录 下 的 activity_main. xml 文件 ,在 右边 的 窗口 可 以 看 到 
文件 的 内 容 , 见 图 1.11. 
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Æ 1.11 Android Studio 开发 界面 


到 这 里 ,就 完成 了 一 个 新 项 目的 创建 。 在 这 个 新 创建 的 HelloWorld App 项 目 中 , 默 
认 创 建 了 一 些 缺 省 文件 ,分别 存放 在 不 同 的 目录 下 , 见 图 1. 11。 下 面 对 其 中 两 个 重要 的 
文件 MainActivity. java 和 activity_main. xml 进行 一 下 说 明 。 

代码 1. 1 是 java 目录 下 的 MainActivity. java 文件 的 具体 内 容 。 

代码 1.1 MainActivity. java 文件 


package it.uibe.edu.cn.helloworld; 


import android.support.v7.app.AppCompatActivity; 
import android.os.Bundle; 


public class MainActivity extends AppCompatActivity { 


@override 

protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity_main); 


从 代码 1.1 中 可 以 看 出 MainActivity 是 Activity ÉB FÆ. Activity 是 Android 系统 
中 用 于 实现 用 户 图 形 界面 的 类 。 
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protected void onCreate ( ) 方 法 是 Activity 所 定义 的 方法 , 当 Activity 启动 时 由 
Android 系统 调用 ,首先 在 这 个 方法 中 执行 初始 化 和 用 户 界面 设置 工作 ,Java 源 程 序 的 
setContentView() 方 法 ,通过 R. layout. activity_main 类 调用 了 activity_main. xml 定义 
的 用 户 界面 ,运行 时 在 屏幕 上 显示 “Hello World!”。 一 个 Activity 并 不 一 定 要 有 用 户 界 
面 ,但 通常 都 会 有 。Activity 概念 可 以 参照 Applet 来 理解 。 

代码 1. 2 是 activity_main. xml 文件 的 具体 内 容 。 

代码 1.2 activity_main. xml 文件 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:paddingBottom="@dimen/activity vertical margin" 
android:paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android:paddingTop="@ dimen/activity vertical margin" 
tools:context="it.uibe.edu.cn.helloworld.MainActivity"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello World!" /> 
</RelativeLayout> 


在 这 个 XML 布局 文件 中 ,元素 TextView 下 的 android: text = " Hello World1" 语 句 
定义 了 屏幕 显示 的 内 容 为 “Hello World!”。 该 布局 文件 的 其 他 功能 和 具体 代码 的 含义 在 
后 续 章 节 解 释 。 

进行 完 上 一 步 的 工作 后 ,就 可 以 运行 App 了 。 

Android App 的 运行 可 以 在 两 个 不 同 的 环境 中 进行 选择 : 真正 的 Android 设备 和 
Android 模拟 器 。 接 下 来 详 述 Android 设备 和 Android 模拟 器 上 安装 和 运行 Android 
App 的 具体 过 程 。 


1.3.2 在 手机 上 运行 HelloWorld App 


下 面 以 Samsung SM-A8000 型 号 的 手机 为 例 ,进行 环境 配置 ,运行 App, 其 他 的 手机 
配置 过 程 类 似 。 

(1) 通过 USB 将 手机 连接 到 计算 机 。 

将 用 于 测试 的 手机 用 USB 连 线 连接 到 计算 机 。 

(2) 设置 手机 的 USB 调试 选项 。 

打开 手机 的 设置 界面 ,打开 “开发 者 选项 ”, 见 图 1. 12 左 图 ;然后 在 打开 后 的 “开发 者 
选项 ”配置 界面 中 ,将 第 一 项 设置 为 “ 开 ” 的 状态 ,“USB 调试 ”设置 为 * 开 ”的 状态 , 见 图 1. 12 
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图 1.12 手机 的 USB 调试 选项 设置 


右 图 。 
(3) 运行 Android Studio 中 的 应 用 程序 HelloWorld App。 


在 Android Studio 中 , 单 击 图 1. 13 中 所 示 的 App 运行 按钮 >, 尝试 运行 
HelloWorld App 程序 。 因 为 这 是 第 一 次 运行 App, 所 以 平台 会 给 出 运行 设备 选择 的 对 话 


框 ,请 先进 行 运行 设备 的 选择 或 配置 。 
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图 1.13 Android Studio 开发 界面 


(4) 选择 运行 设备 。 


因为 前 面 已 经 设置 了 手机 的 开发 者 USB 调试 选项 ,成 功 与 设备 连接 后 ,在 运行 设备 


选择 对 话 框 中 会 出 现 所 连接 的 手机 选项 , 见 图 1. 14。 
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@ Select Deployment Target x 


Connected Devices 





Samsung SM-A8000 (Android 5.1.1, API 22) 


Create New Emulator Don't see your device? 
Use same selection for future launches | o |] 


图 1.14 选择 设备 对 话 框 























选择 手机 设备 作为 运行 设备 , 单 击 OK 按钮 ,在 手机 上 运行 HelloWorld App。 

(5) App 在 手机 上 安装 运行 。 

在 手机 上 运行 App 的 速度 很 快 ,几乎 马上 就 可 以 从 手机 上 看 到 图 1. 15 左 图 所 示 的 
结果 。 从 App 返回 手机 的 主 界 面 ,可 以 看 到 屏幕 上 出 现 一 个 绿色 小 机 器 人 ,表明 
HelloWorld App 已 经 装载 到 了 手机 上 ,可 以 单 击 其 图 标 。 


u [FF 1] 
HelloWorld 


Heto World! 














图 1.15 手机 运行 结果 


在 手机 上 执行 App ,实际 上 是 把 Android Studio 编译 后 的 apk 文件 装载 到 手机 并 执 
行 的 过 程 ,相当 于 从 网 上 下 载 应 用 ,并 安装 后 执行 的 过 程 。 在 开发 过 程 中 ,可 以 一 直 使 用 
手机 来 进行 开发 App 的 调试 和 测试 ,但 大 多 数 情况 下 ,会 使 用 Android 手机 模拟 器 , 即 
AVD 来 进行 调试 .运行 和 测试 。 因 为 AVD 可 以 根据 需要 设置 成 不 同 Android 版 本 、 不 
同 显示 模式 \ 不 同性 能 ,不 同 厂商 的 模拟 运行 环境 ,对 App 进行 多 方面 的 测试 ,有 利于 所 
开发 App 的 兼容 性 、 健 壮 性 和 适应 性 。 
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1.3.3 Æ AVD 上 运行 HelloWorld App 


不 对 上 面 的 程序 做 任何 修改 ,下 面 在 模拟 器 上 运行 该 App。Android 模拟 器 能 够 模 
拟 App 在 真实 手机 上 的 运行 效果 和 功能 ,在 开发 过 程 中 支持 程序 员 对 Android App 进行 
代码 测试 .调试 和 运行 。 

如 果 刚 才 在 手机 上 运行 了 HelloWorld App, 首 先 要 断 开 与 手机 的 USB 连接 ,然后 再 
进行 下 面 的 步骤 。 

d) 在 创建 AVD 之 前 ,需要 先 安装 HAXM, 即 Hardware Accelerated Execution 
Manager, Intel 的 硬件 加 速 执行 管理 器 。 

选择 Tool->Android->SDK Manager, 单 击 对 话 框 中 的 蓝 色 链接 Launch Standalone 
SDK Manager, 打开 独立 的 Android SDK Manager, 将 右边 的 滚动 条 拖 忠 到 最 底部 ,可 以 
看 到 最 后 一 个 选项 Intel x86 Emulator Accelerator (HAXM installer) , 见 图 1. 16。 






























































Android SDK Manager _ D x 
Packages Tools 
SDK Path: C\Users\van\AppData\Loca\Android\sdk 
Packages 
iW' Name API Rev. Status = 
B. Google Play Biling Library 5 Wotinstaled 
Ë Android Auto API Simulators 1 O Not installed 
B. Google USB Driver 11 Ë Installed 
B Google Web Driver 2 O Not installed 
EJ B. /ntel x86 Emulator Accelerator (HAXM instal 60.3 [O Not installed 
v 
< > 
Show: 回 Updates/New 回 Installed Select New or Updates | Install 2 packages.. 
口 obsolete select All | Delete 1 package... 
| 
l O w 
Done loading packages. 





Æ 1.16 Android SDK Manager 


P X 638, 8 Jai  E Y ta 18 zJ 2& , F] P h Br qa 38: API level( 例 如 API 23) 中 的 
Intel x86 Atom System Image sË Intel x86 Atom_86 System Image 选项 , 单 击 右 下 的 按 
£H Install 2 packages ,安装 这 两 个 包 。 

要 注意 的 是 ,虽然 安装 完成 ,在 Status 栏 显示 Installed, 但 HAXM 并 没有 真正 安装 
到 系统 ,还 需要 进入 HAXM 安装 包 所 在 的 目录 手动 安装 HAXM。 具 体 路 径 是 Windows 
用 户 目 录 下 的 AppData\Local\ Android \ sdk \ extras \ intel \ Hardware _ Accelerated _ 
Execution_Manager, 

(2) 单 击 Android Studio 的 运行 按钮 ,运行 Android Studio 中 的 应 用 程序 
HelloWorld App. 

(3) 在 图 1. 14 所 示 的 选择 设备 对 话 框 中 单 击 Create New Emulator 按钮 ,创建 运行 
App 的 模拟 设备 AVD(Android Virtual Device). 


第 1 章 Androd 开发 基础 


(4) 在 接 下 来 的 对 话 框 中 选择 模拟 的 手机 型 号 、Android 的 版 本 及 API level, 进 行 模 
拟 器 配置 ,然后 在 最 后 一 个 对 话 框 中 检查 各 项 配置 是 否 正确 ,在 AVD Name 对 应 的 文本 
框 中 给 出 AVD 的 名 称 , 单 击 Finish 按钮 ,完成 AVD 创建 , 见 图 1. 17。 第 一 次 配置 可 以 
采用 默认 设置 。 
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图 1.17 AVD 配置 


(5) 在 图 1. 14 所 示 的 选择 设备 对 话 框 中 ,双击 刚才 所 创建 的 AVD,Android Studio 
会 把 HelloWorld App, 也 就 是 HelloWorld. apk 文件 ,安装 到 AVD 上 并 运行 。 

这 时 需要 真正 耐心 地 等 待 运行 结果 。 一 般 来 说 ,第 一 次 在 仿真 器 上 运行 Android 应 
用 程序 需要 花 很 长 时 间 。 具 体 的 时 间 与 机 器 性 能 和 配置 有 关 。 

如 果 运 行 3 一 4 分 钟 却 只 看 到 仿真 器 上 的 Android 在 闪烁 , 见 图 1. 18 左 图 ,此 时 不 要 
着 急 ,请 耐心 等 待 。 

几 分 钟 之 后 ,可 以 看 到 图 1. 18 中 图 所 示 的 运行 结果 显示 在 屏幕 上 。 图 1. 18 右 图 的 
工具 条 是 对 模拟 器 手机 进行 操作 的 各 种 功能 按钮 ,可 以 实现 关机 、 调 节 声 音 大 小 、 摇 动 . 照 
相等 功能 。 如 果 单 击 0 ,就 回 到 手机 Home 的 状态 ,通过 单 击 应 用 程序 图 标 ,可 以 看 到 手 
机 上 装载 的 应 用 程序 ,从 中 找到 刚才 所 运行 的 HelloWorld App 的 白 底 绿色 小 机 器 人 
图 标 。 

(6) AVD 可 以 创建 多 个 ,如 果 要 在 后 续 的 App 开发 过 程 中 默认 使 用 某 个 AVD, 在 双 
击 它 之 前 ,选中 图 1. 14 中 的 Use same selection for future launches 复 选 框 。 

Android Studio 的 AVD 除了 可 以 在 运行 App 时 在 选择 设备 配置 时 创建 ,还 可 以 在 
其 提供 的 AVD 管理 工具 里 进行 创建 删除、 修改 等 操作 ,具体 的 操作 通过 选择 Tool > 
Android>A VD Manager, 在 弹出 的 对 话 框 中 进行 。 


NB 
—— 
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1.18 AVD 运行 结果 


134 定义 简单 的 用 户 界面 


上 面 完 成 的 “Hello World!” 应 用 程序 ,其 用 户 界面 所 显示 的 内 容 是 由 Android 
Studio 的 默认 布局 文件 activity_main. xml 定义 。 其 中 使 用 元 素 TextView 定义 了 一 个 
文本 框 ,来 显示 “Hello World!” 的 内 容 。 

Android 系统 推荐 使 用 XML 布局 文件 来 设计 用 户 界面 。 所 有 的 XML 布局 文件 都 
位 于 App 项 目的 res/layout/ 目 录 中 。 使 用 这 种 方式 ,可 以 很 方便 地 定义 结构 化 的 用 户 图 
形 界 面 ,图 形 组 件 的 布局 和 相互 之 间 的 关系 可 以 很 容易 、 清 楚 地 设 定 。 同 时 也 可 以 避免 直 
接 在 源 代码 中 构建 应 用 程序 的 用 户 界面 ,导致 一 些小 的 布局 变化 引起 Java 源 代 码 的 大 量 

在 Android Studio 中 提供 两 种 定义 XML 布局 文件 的 方式 : 图 形 化 构建 和 编写 XML 
代码 。 在 这 里 ,采用 直接 编写 XML 代码 的 方式 ,定义 一 个 自己 简单 的 用 户 界面 ,替换 前 
面 的 “Hello World!” 用 户 界 面 。 

1. 编写 布局 文件 

在 Project 的 app 目录 中 ,展开 res/layout/ 文 件 夹 ,双击 打开 activity_main. xml X: 
件 , 清 除 原来 的 所 有 内 容 , 蔡 换 成 代码 1. 3 中 的 内 容 , 编 写 自 己 的 用 户 界面 布局 。 

代码 1.3 自己 定义 的 activity_main. xml 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 
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<EditText android:id="@+id/edit message" 
android:layout weight="1" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:;hint="@string/edit message" /> 

<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/button send" /> 

</LinearLayout> 


Android App 用 户 图 形 界面 是 使 用 Android 系统 的 View 和 ViewGroup 子 类 , 按 层 
次 结构 搭建 而 成 的 。 例 如 按钮 和 文本 框 等 UI 小 组 件 是 View 对 象 ,而 列表 和 网 格 等 容器 
是 ViewGroup 对 象 。Android XML 布局 文件 就 是 通过 树 形 结构 ,来 说 明 在 屏幕 上 所 要 
显示 的 各 组 件 相互 的 层次 关系 和 具体 如 何 显示 的 。 一 个 Android XML 文件 的 总 体 结构 
比较 简单 ,就 是 一 棵 XML 元 素 的 树 , 树 中 的 每 个 节点 都 使 用 View 类 的 子 类 名 作为 元 素 
名 称 ,每 一 个 元 素 都 对 应 一 个 用 户 图 形 界 面 中 的 组 件 。 通 过 树 的 根 和 分 支 之 间 的 关系 , 定 
义 了 用 户 图 形 界 面 中 组 件 之 间 的 关系 。 

在 代码 1. 3 的 XML 布局 文件 中 ,就 是 一 个 以 LinearLayout 元 素 作为 根 的 一 棵 树 ,在 
该 布局 文件 中 定义 了 两 个 图 形 组 件 EditText 和 Button 作为 子 元 素 。 下 面 对 acitvity_ 
main. xml 布局 文件 中 的 代码 含义 进行 解释 。 

1) android:id 

这 个 属性 为 子 元 素 所 定义 的 View 对 象 提供 了 唯一 的 标识 ,应 用 程序 可 以 通过 这 个 
ID 识别 .操作 或 获取 这 个 对 象 。 

另外 ,在 XML 文件 中 引用 任何 一 个 其 他 XML 文件 中 的 资源 时 ,, 需 要 以 @ 开 头 ,后 
面 跟 随 资源 的 类 型 .一 个 斜 线 和 资源 名 称 。 例 如 ," @ string/edit_ message" 表示 应 用 
string 类 型 的 资源 ,这 个 资源 的 名 称 是 edit_message, string 资源 在 /res/strings 中 定义 。 

如 果 在 @ 后 、 资 源 类 型 前 添加 一 个 十 ,表示 定义 一 个 资源 的 ID. 

2) android:layout_width 和 android:layout_height 

这 两 个 属性 定义 View 对 象 的 可 用 宽度 和 长 度 。 值 match_parent 表示 占据 其 父 节点 
ViewGroup 所 占据 的 整个 空间 ; 值 wrap_content 表示 根据 View 的 内 容 大 小 来 设 定 对 象 
的 大 小 。 通 过 设 定 不 同 的 值 ,View 对 象 的 外 形 有 所 变化 ,执行 性 能 也 会 有 所 不 同 。 例 如 
在 这 里 EditText 的 属性 中 layout_weight =" 1"#l layout_width 王 "0dp" 配合 使 用 ,会 减 
少 系统 计算 量 ,改善 应 用 的 性 能 。 

3) android:hint 

这 个 属性 设 定 EditText 中 默认 显示 的 字符 串 。 如 果 没 有 预先 设 定 这 个 属性 ， 
EditText 初始 显示 为 空 。 这 里 没有 直接 给 这 个 属性 赋 一 个 字符 串 常量 值 , 而 是 使 用 了 一 
个 string 资源 引用 @ string/edit_message, 指向 字符 串 资源 文件 中 定义 的 名 称 为 edit_ 
message 的 资源 。 字 符 串 定义 在 res/values/strings. xml 文件 中 。 这 是 一 种 推荐 的 方式 ， 


/ 
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因为 这 可 以 使 应 用 程序 能 够 很 好 地 本 地 化 ,而 不 需要 改变 布局 文件 。 

4) android :text 

这 个 属性 设置 了 Button 上 显示 的 文本 。 这 里 同样 使 用 了 字符 串 资源 而 不 是 直接 给 
出 了 字符 串 值 。 

2. 添加 string 资源 

在 Project 的 app 目录 中 ,展开 res/values/ 文 件 夹 ,双击 打开 strings. xml 文件 ,添加 
新 的 字符 串 定义 。 一 个 名 称 为 edit_message, 值 为 Enter a message; 另 一 名 称 为 button_ 
send, 值 为 Snd。 代 码 1. 4 为 添加 新 的 字符 串 定义 后 strings. xml 的 内 容 。 

代码 1.4 strings. xml 


<?xml version="1.0" encoding="utf-8"?> 

<resources> 
<string name="app name">My First App</string> 
<string name="edit message">Enter a message</string> 
<string name="button send">Send</string> 


</resources> 


3. 运行 App 
单 击 Run App 运行 按钮 ,运行 修改 后 的 
App, 可 以 得 到 新 的 界面 , 见 图 1. 19 。 日 


HelloWorld 
135 启动 另 一 个 Activity 


完成 上 面 的 步骤 之 后 ,实现 了 自己 设计 的 
MainActivity 界面 ,但 界面 上 的 Button 还 不 能 
响应 单 击 的 事件 。 下 面 实现 单 击 SEND 按钮 图 1.19 新 的 MainActivity 界面 
后 ,把 EditText 输入 的 信息 传递 到 另 一 个 
Activity, 通 过 这 个 消息 启动 该 Activity ,显示 传递 过 来 的 信息 。 具 体 实现 需要 下 面 几 个 
步骤 。 

1. 响应 SEND 按钮 单 击 事件 

首先 ,修改 MainActivity 的 布局 文件 res/layout/activity_main. xml, 给 Button 元 素 
添加 一 个 属性 android:onClick, 见 代码 1. 5。 

代码 1.5 添加 Button 的 android:onClick 属性 


Enter a message 








<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/button send" 
android:onClick="sendMessage" /> 


android :onClick 的 属性 值 可 以 设 定 为 某 个 字符 串 。 设 定 后 ,任何 时 候 单 击 这 个 按 
钮 ,系统 就 会 调用 这 个 图 形 组 件 所 在 的 Activity 子 类 中 以 这 个 属性 值 命名 的 方法 来 进行 
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件 处 理 。android:onClick 的 值 由 程序 员 自 己 来 设 定 。 例 如 ,这 里 这 个 按钮 的 android: 
onClick 值 设 定 为 sendMessage(), 单 击 这 个 按钮 时 , 则 由 MainAcivity 中 的 sendMessage() 
方法 来 进行 按钮 单 击 事件 处 理 。 该 sendMessage() 方 法 由 程序 员 手 动 添加 。 

在 添加 如 代码 1. 6 所 示 的 sendMessage() 方 法 时 要 注意 三 点 : 

。 方 法 的 访问 控制 权限 必须 是 public。 

。 返回 值 的 类 型 必须 是 void。 

。 只 能 使 用 一 个 View 对 象 作 为 参数 ,这 个 对 象 就 是 产生 事件 的 对 象 。 

代码 1.6 添加 sendMessage() 








package it.uibe.edu.cn.helloworld; 


import android.content.Intent; 

import android.support.v7.app.AppCompatActivity; 
import android.os.Bundle; 

import android.view.View; 


import android.widget.EditText; 


public class MainActivity extends AppCompatActivity { 
public final static String EXTRA_MESSAGE="it.uibe.edu.cn.helloworld. 
MESSAGE"; 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
setContentView (R.layout.activity main); 


/** Called when the user clicks the Send button * / 

public void sendMessage (View view) { 
Intent intent=new Intent (this, DisplayMessageActivity.class); 
EditText editText= (EditText) findViewById(R.id.edit message); 
String message=editText.getText().toString(); 
intent.putExtra (EXTRA MESSAGE, message); 
startActivity(intent); 


} 


下 一 步 就 可 以 在 sendMessage() 方 法 中 添加 事件 处 理 代码 ,实现 信息 传递 和 启动 另 
一 个 Activity 了 。 

2. 创建 Intent 对 象 传递 消息 

Android 的 Intent 机 制 可 以 在 运行 时 绑 定 两 个 独立 的 组 件 , 利 用 Intent 对 象 在 不 同 
组 件 之 间 传 递 消息 。 
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修改 MainActivity. java 文件 ,在 sendMessage() 中 创建 Intent 对 象 ,通过 R. id. edit_ 
message 获取 布局 文件 中 定义 的 EditText 对 象 , 并 通过 Intent 的 putExtra() 方 法 ,把 
Edit Text 中 的 文本 信息 赋 给 Intent 对 象 ,然后 通过 Intent 启动 男 一 个 指定 的 .名称 为 
DisplayMessageActivity 的 Activity, 见 代码 1.7。 

代码 1.7 修改 后 的 MainActivity. java 


public class MainActivity extends AppCompatActivity { 
public final static String EXTRA_MESSAGE="it.uibe.edu.cn.helloworld. 
MESSAGE"; 


@override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout.activity_main); 


/xx Called when the user clicks the Send button * / 

public void sendMessage (View view) ( 
Intent intent=new Intent (this, DisplayMessageActivity.class); 
EditText editText= (EditText) findViewById(R.id.edit message); 
String message=editText.getText().toString(); 
intent.putExtra (EXTRA MESSAGE, message); 
startActivity (intent); 


} 


注意 在 MainActivity 定义 的 第 一 行 添加 EXTRA_MESSAGE 常量 的 定义 。 

修改 代码 后 ,平台 会 通过 红色 字体 提示 错误 。 这 时 ,可 以 通过 连续 按 Alt 十 Enter 键 
载 人 所 需 的 类 。DisplayMessageActivity 是 需要 在 下 一 步 定 义 的 另 一 个 Activity 。 

3. 创建 另 一 个 Activity 

在 Android Studio 的 Project 窗口 , 右 击 app 文件 夹 ,选择 New 一 Activity> Empty 
Activity, 创 建 另 一 个 Activity, 见 图 1. 20。 

在 Activity 配置 窗口 的 Activity Name 对 应 的 文本 框 中 输入 DisplayMessageActivity， 
可 以 看 到 默认 布局 文件 名 设置 为 activity_display_message. xml, 然 后 单 击 Finish 按钮 。 

打开 res/values 目录 下 的 activity_display_message. xml 文件 ,添加 TextView 元 素 ， 
见 代码 1. 8。 

代码 1.8 添加 TextView 组 件 


<TextView android:id="@+id/text show msg" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 
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Æ 1.20 创建 新 的 Activity 


打开 java 目录 it. uibe. edu. cn. helloworld 包 的 DisplayMessageActivity. java 文件 ， 
在 onCreate() 方 法 中 添加 获取 MainActivity 发 送 Intent 中 的 信息 ,并 把 信息 显示 在 布局 
文件 定义 的 TextView 组 件 上 , 见 代码 1.9. 

代码 1.9 DisplayMessage 


package it.uibe.edu.cn.helloworld; 


import android.content.Intent; 

import android.support.v7.app.AppCompatActivity; 
import android.os.Bundle; 

import android.view.ViewGroup; 


import android.widget.TextView; 
public class DisplayMessageActivity extends AppCompatActivity { 
@Override 


protected void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState); 
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4. 添加 该 Activity 到 manifest 文件 

完成 Activity 的 代码 编写 后 ,需要 把 这 个 Activity 元 素 添加 到 manifest 文件 中 ,打开 
manifests 文件 夹 中 的 AndroidManifest. xml, 会 发 现 DisplayMessageActivity 元 素 已 经 
被 Android Studio 加 入 到 了 文件 中 , 见 代 码 1. 10。 

代码 1.10 新 的 AndroidManifest. xml 
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在 以 后 开发 过 程 中 ,每 一 个 Activity 都 必须 添加 到 AndroidManifest. xml 中 ,如 果 发 
现 没有 自动 添加 ,就 必须 手动 把 信息 添加 进去 。Manifest 文件 的 具体 编写 ,和 元 素 与 属性 
的 含义 会 在 下 一 节 详 细 说 明 。 

5. 运行 App, 发 送 并 显示 消息 

单 击 Run App 运行 按钮 ,运行 修改 后 的 App, 在 MainActiivty 界面 输入 信息 , 单 击 
SEND 按钮 ,可 以 看 到 系统 启动 了 另 一 个 Acitivity, 即 DisplayMessageActivity, 并 把 前 一 
+ Activity 中 输入 的 信息 显示 在 屏幕 上 , 见 图 1. 21 。 





Hello, Android 
Mobile World ! 
This is my first App! 


w w di fio N THE J 
*zxcvbnmea 


° 





图 1.21 运行 结果 


到 此 为 止 ,就 完成 了 第 一 个 App 的 开发 。 
1.4 使 用 Android Studio 


1.4.1 Android Project 的 目录 结构 


每 一 个 Android App 都 可 以 由 一 个 Project 来 实现 。Android Project 把 与 源 文件 和 
资源 文件 等 项 目 相关 的 文件 划分 为 不 同 的 模块 进行 管理 。 模 块 的 主要 类 型 如 下 : 

。 app 模块 (Android App Modules) 。 

。 库 模 块 (Library Modules) 。 

。 Google App 引擎 模块 (Google App Engine Modules) 。 

默认 情况 下 ,Android Studio 2. 1.2 在 Android Project 视图 中 可 以 显示 当前 开发 的 
Project 的 所 有 文件 , 见 图 1.22。 这 些 文件 分 布 在 不 同 的 模块 中 ,根据 其 特征 很 容易 访问 。 

在 Gradle Scripts 模块 中 包含 所 有 的 build 文件 。app 模块 包括 三 个 个 文件 夹 : 

。 manifests: 包含 AndroidManifest. xml 文件 。 

° java: 包含 Java 源 代码 文件 ,其 中 包括 JUnit 测试 代码 。 





`> 
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。 res; 包含 所 有 的 非 代 码 资 源 ,例如 XML 布局 文件 .UI 字符 串 和 位 图 图 片 等 。 
其 中 , AndroidManifest. xml 主要 是 说 明 App 
的 名 称 、 版 本 、SDK, 以 及 App 项 目 中 有 哪些 组 件 、 
权限 如 何 配 置 \ 在 一 些 条 件 下 启动 哪些 组 件 。 在 
App 中 运行 的 所 有 组 件 都 必须 在 AndroidManifest. 
xml 说 明 , 进行 必要 的 配置 , 否则 无 法 执行 。 










Y D manifests 
ËŠ AndroidManifestxml 
Y Djaa 
> E ituibe.edu.cn.helloworid 
> E ituibe.edu.cn.helloworld (androidTest) 
> E ituibe.edu.cn.helloworid (test) 








i PEBE Android-Manifest. xml 具 体 的 设置 和 所 使 用 的 语法 ， 
y Elpa 在 1.4.2 节 中 详细 描述 。 


@ Captures < I: Structure [3 


> È values 

Y È Gradle Scripts 
È build.gradle (Project: HelloWorld) 
(Ë build.gradle (Module: app) 


Java 源 代码 文件 是 App 中 的 可 执行 代码 , 主要 
是 App 功能 执行 逻辑 的 描述 以 及 实现 。 不 同 组 件 
和 功能 的 具体 实现 方式 ,在 后 续 章 节 中 具体 描述 。 

res 目录 为 资源 目录 ,而 res 就 是 resources 的 缩 
写 , 分 别 是 Java 源 代码 运行 中 所 需要 使 用 的 不 同 资 
源 ,这 些 资 源 以 不 同 的 文件 格式 分 类 存储 在 不 同 的 

图 1.22 Project 模块 和 文件 目录 下 。 
res 目录 下 所 有 的 资源 文件 都 会 在 R. java 文件 

下 生成 对 应 的 资源 ID, 可 以 直接 通过 资源 id 访问 到 对 应 的 资源 ;这 个 R 文 件 可 以 理解 为 
字典 ,res 下 每 个 资源 都 会 在 这 里 生成 一 个 唯一 的 ID。 下 面 介 绍 一 些 常用 的 res 资源 。 

1. 图 片 资源 res/ drawable/ 

res/ drawable/ 目录 用 来 存放 各 种 位 图 文件 ,例如 . png.. jpg.. 9. png、 gif 等 文件 ,也 
可 能 是 一 些 其 他 的 drawable 类 型 的 XML 文件。 通常 位 图 文件 存储 的 子 目 录 如 下 : 
mipmap-hdpi: 高 分 辩 率 ,适合 目前 大 多 数 手机 ,开发 时 一 般 使 用 这 种 格式 。 
mipmap-mdpi: 中 等 分 辩 率 ,很 少 ,适合 低 端 或 者 比较 老 的 手机 。 
mipmap-xhdpi: 超 高 分 辩 率 ,手机 屏幕 材质 越 来 越 好 ,以 后 估计 会 慢 慢 往 这 里 
过 渡 。 
mipmap-xxhdpi: 超 超 高 分 辨 率 , 适 合 高 端 机 。 

Frame 动画 资源 也 放 在 这 个 目录 ,通过 R. drawable 类 来 访问 。 

2. 布局 文件 res/layout/ 

res/layout/ 目 录用 来 存放 布局 文件 。activity_main. xml 布局 文件 是 Android 项 目 生 
成 时 自动 产生 的 主 界面 布局 文件 ,程序 员 可 以 根据 自己 的 界面 设计 ,定义 、 命 名 自己 的 布 
局 文件 ,还 可 以 根据 不 同 的 手机 尺寸 或 分 辨 率 ,为 同一 个 功能 定义 不 同 的 布局 。 

3. res/mipmap 

该 目录 定义 应 用 程序 使 用 的 图 标 资源 。 

4. res/values/ 

该 目录 下 使 用 不 同文 件 定义 菜单 .样式 、 颜 色 、 维 度 、 字 符 串 、 字 符 串 数组 和 数量 字符 
串 等 。 经 常 使 用 的 文件 如 下 : 

* demens. xml; 定义 尺寸 资源 。 


Ë) proguard-rules.pro (ProGuard Rules for ap| 
[À gradle.properties (Project Properties) 

© settings.gradle (Proje, 
[2 local.properties (SDK 
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strings. xml: 定义 字符 串 资源 。 
styles. xml: 定义 样式 资源 。 
colors. xml: 定义 颜色 资源 。 
arrays. xml: 定义 数组 资源 。 
menu. xml; 定义 菜单 资源 。 
attrs. xml: 自 定义 控件 的 属性 。 
theme. xml: 定义 主题 文件 。 
例如 ,strings. xml 用 于 定义 应 用 程序 或 其 他 资源 文件 中 使 用 的 字符 串 和 数值 等 ,类 
似 于 定义 属性 值 的 资源 文件 。 前 面 创建 的 HelloWorld 项 目 中 的 strings. xml 文件 内 容 
如 下 : 


<resources> 
<string name="app name">HelloWorld</string> 


</resources> 


其 中 ,string 标签 声明 一 个 字符 串 ,name 属性 指定 其 引用 名 。 把 应 用 中 出 现 的 文字 
单独 存放 在 strings. xml 文中 的 原因 有 二 : 一 是 为 了 国际 化 ;二 是 为 了 减少 应 用 体积 , 降 
低 数据 元 余 。 

5. 动画 资源 res/anim/ 

res/anim/ 用 于 定义 预先 确定 的 Tween 动画 资源 ,通过 R. anim 类 来 访问 。 使 用 
Tween 方式 实现 的 动画 ,可 以 使 视图 组 件 移动 、 放 大 缩小 以 及 产生 透明 度 的 变化 ,相对 
于 传统 按 帧 播放 的 Frame 动画 ,更 具有 灵活 性 。 


1.42 AndroidManifest.xml 分 析 


AndroidManifest. xml 文件 是 当前 Android 项 目的 功能 清单 文件 ,该 文件 列 出 了 应 
用 中 所 使 用 的 所 有 组 件 。 只 有 在 AndroidManifest. xml 文件 中 声明 了 的 组 件 ,才能 够 在 
项 目 启动 时 运行 。 

前 面 所 建 HelloWorld 项 目的 AndroidManifest. xml 文件 内 容 见 代码 1. 11。 

代码 1.11 AndroidManifest. xml 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="it.uibe.edu.cn.helloworld"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
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android:theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android. intent.category .LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


AndroidManifest. xml 文件 中 采用 了 特定 的 标记 ,来 描述 Android 项 目 中 应 用 程序 
或 组 件 的 名 称 \ 特 性 等 。 下 面 是 一 些 主要 标记 的 说 明 。 

—maniíest2>; 根 节点 ,描述 了 Package 中 所 有 的 内 容 。 

xmlns:android: 包含 命名 空间 的 说 明 ,该 命名 空间 使 得 Android 中 各 种 标准 属性 能 
在 文件 中 使 用 。 

package: 声明 应 用 程序 包 。 

android:versionCode: 该 应 用 程序 版 本 代号 。 

android:versionName: 该 应 用 程序 版 本 名 称 。 

uses-sdk: 该 应 用 程序 所 使 用 的 SDK 版 本 。 

<application>: 包含 Package 中 Application 级 别 组 件 声明 的 根 节 点 。 此 元 素 也 可 
WA application 的 一 些 全 局 和 默认 的 属性 ,如 标签 .icon 主题 ,必要 的 权限 等 。 一 个 
manifest 中 至 多 包含 一 个 此 元 素 。 

android:icon: 应 用 程序 图 标 。 

android :label: 应 用 程序 名 。 

activity: 是 用 户 打 开 的 一 个 应 用 程序 的 初始 页 面 ,大 部 分 被 使 用 到 的 其 他 页 面 也 由 
不 同 的 activity 所 实现 。 每 个 activity 必须 有 一 个 一 activity 之 标记 对 应 ,无 论 它 给 外 部 使 
用 或 是 只 用 于 自己 的 Package 中 。 为 了 支持 运行 时 查找 Activity, 可 包含 一 个 或 多 个 
<intent-filter> JCR KHR Activity 所 支持 的 操作 。 

android:name: 应 用 程序 默认 启动 的 Activity。 

intent-filter: 声明 了 指定 的 一 组 组 件 支持 的 Intent 值 ,从 而 形成 了 IntentFilter。 除 
了 能 在 此 元 素 下 指定 不 同类 型 的 值 ,属性 也 能 放 在 这 里 来 描述 一 个 操作 所 需 的 唯一 标签 、 
icon 和 其 他 信息 。 

action: 组 件 支持 的 Intent Action, 

category: 组 件 支持 的 Intent category。 这 里 指定 了 应 用 程序 默认 启动 的 Activity。 

在 所 有 的 元 素 中 只 有 <<manifest 之 和 <<application 之 是 必需 的 , 且 只 能 出 现 一 次 。 如 
果 一 个 元 素 包 含有 其 他 子 元 素 , 必 须 通过 子 元 素 的 属性 来 设置 其 值 。 处 于 同一 层次 的 元 
素 的 说 明 是 没有 顺序 的 。 


第 1 章 Androd 开发 基础 


在 文件 的 树 中 ,最 外 层 的 一 manifest 盖 中 包含 了 包 名 如 package= "cn. androidlover. 
demo”、 软 件 的 版 本 号 android:versionCode="1" 以 及 android:versionName 一 "1.0" 的 
属性 。 

里 面 一 层 子 元 素 二 application 之 分 支 中 ,将 可 能 包含 Android 程序 的 四 大 基础 组 件 
Activity、Service、ContentProvider 以 及 Receiver 中 任 一 类 型 的 对 象 。 如 果 在 应 用 程序 中 
添加 上 面 四 个 类 型 中 的 任 一 种 新 对 象 ,都 需要 在 AndroidManifest. xml 文件 中 添加 相应 
节点 ,否则 运行 时 将 会 产生 异常 。 例 如 ,对 于 一 个 Activity 来 说 ,无 论 给 外 部 使 用 或 是 只 
用 于 自己 的 package 中 ,都 必须 要 一 个 <<activity 之 标记 对 应 进行 说 明 。 如 果 Activity 没 
有 对 应 的 标记 ,就 不 能 运行 。 

AndroidManifest. xml 文件 中 各 元 素 以 及 它们 的 属性 都 是 可 选 的 ,但 即使 没有 在 文 
件 中 显示 设置 ,它们 也 都 有 默认 的 设置 。 除 了 根 元 素 二 manifest 之 的 属性 ,所 有 其 他 元 素 
属性 的 名 字 都 是 以 “android:” 作 为 前 级 的 。 

下 面 是 定义 AndroidManifest. xml 元 素 时 需要 注意 的 地 方 。 

。 定义 类 名 。 

所 有 的 元 素 名 都 对 应 其 在 SDK 中 的 类 名 ,如 果 是 自 定义 类 名 ,必须 包含 类 的 数据 包 
名 ,如 果 类 与 application 处 于 同一 数据 包 中 ,可 以 直接 简写 为 ".”。 

。 多 数值 项 。 

如 果 某 个 元 素 的 属性 有 超过 一 个 数值 ,必须 通过 重复 的 方式 来 说 明 这 个 属性 具有 多 
个 数值 项 , 且 不 能 将 多 个 数值 项 一 次 性 说 明 在 一 个 属性 中 。 

。 资源 项 说 明 。 

当 需 要 引用 某 个 资源 时 ,需要 按照 规范 的 格式 : @[package:]type: name。 例 如 
一 activity android:icon 一 "@drawable/icon”… 二 。 

。 字符 串 值 。 

类 似 于 其 他 语言 ,如 果 字 符 中 包含 有 字符 “\”, 则 必须 使 用 转 义 字符 “\\”。 

AndroidManifest. xml 文件 中 的 元 素 是 规定 的 ,不 能 加 入 自己 创建 的 元 素 和 属性 。 
下 面 是 按照 字母 顺序 排列 的 所 有 可 以 出 现在 AndroidManifest. xml 文件 里 的 元 素 , 它 们 
是 唯一 合法 的 元 素 。 


<action> 
<activity> 
<activity-alias> 
<application> 
<category> 

<data> 
<grant-uri-permission> 
<instrumentation> 
<intent-filter> 
<manifest> 
<meta-data> 


` 
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<Permission> 
<permission-group> 
<permission-tree> 
<provider> 
<receiver> 

<service> 
<uses-configuration> 
<uses-library> 
<uses-permission> 


<uses-sdk> 


1.5 Android App 开发 起 步 


1.5.1 App 开发 流程 


Android 应 用 程序 , 即 Android App, $ H Java 语言 作为 开发 语言 ,通过 Android 
SDK 工具 编译 代码 后 ,与 应 用 文件 所 使 用 的 资源 文件 和 数据 等 部 分 一 起 ,生成 Android 
Package 文件, 即 . apk 文件 。 当 用 户 下 载 安 装 一 个 Android App 时 ,安装 的 文件 就 是 
.apk 文件 。 

Android App 开发 过 程 中 ,把 应 用 程序 逻辑 和 用 户 界 面 设 计 完 全 分 隔 开 ,可 以 分 别 进 
行 独立 的 设计 和 开发 。 应 用 程序 逻辑 使 用 Java 代码 实现 ;而 用 户 界面 设计 可 以 使 用 图 形 
工具 或 XML 文件 ,定义 图 形 界 面 的 组 件 和 具体 布局 。 理 论 上 ,在 这 种 模式 下 应 用 程序 的 
逻辑 改变 ,不 会 影响 用 户 界面 的 设计 ,不 需要 修改 ;用 户 界面 设计 的 布局 调整 ,也 不 需要 修 
改 相应 的 Java 代码 。 虽 然 实 际 开发 中 不 能 完全 实现 二 者 隔离 ,但 大 大 减少 了 代码 的 修改 
IFE. 

在 Android Studio 平台 上 开发 Android App ,与 在 其 他 平台 上 开发 的 流程 基本 一 致 。 
作为 Android App 专用 开发 平台 ,Android Studio 平台 把 开发 过 程 中 所 需 的 一 些 设计 和 
开发 的 专用 工具 ,例如 用 户 界面 图 形 设计 工具 、Android SDK. AVD 等 ,统一 规整 到 一 个 
安装 包 中 ,安装 后 就 具有 开发 中 所 需要 的 所 有 工具 ,不 再 需要 逐个 安装 测试 。 下面 是 在 
Android Studio 中 开发 App 的 开发 流程 , 见 图 1. 23。 

1. 安装 

在 这 个 阶段 ,需要 下 载 Android Studio 安装 包 , 安 装 Android 开发 环境 后 ,配置 AVD 
和 测试 设备 ,并 通过 HelloWorld App 测试 整个 平台 的 各 项 功能 ,熟悉 所 安装 版 本 平台 的 
工具 和 Project 的 组 织 结构 ,为 正式 开发 App 做 好 准备 。 

2. 开发 

这 个 阶段 ,首先 需要 创建 App 对 应 的 项 目 (Project) 。 所 开发 App 的 所 有 相关 文件 
会 以 Project 的 目录 形式 分 类 存放 在 Project 中 。 这 一 阶段 的 任务 分 为 三 个 部 分 , 见 
图 1.23。 

其 中 ,UI 设计 主要 是 用 户 界 面 的 组 件 定 义 和 布 局 设计 ,可 以 使 用 Android Studio 的 
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图 1.23 Android App 开发 流程 图 


图 形 工具 实现 ,也 可 以 直接 使 用 XML 语言 来 直接 编写 。 无 论 哪 种 形式 ,最 后 UI 的 设计 
代码 都 以 xml 文件 形式 存储 在 资源 文件 目录 res 中 ;资源 和 数据 组 织 主 要 是 把 图 形 、 图 
标 、 网 络 链接 等 资源 和 数据 通过 资源 文件 存放 在 res 合适 的 目录 中 。 

Java 源 程序 代码 ,主要 实现 用 户 界面 的 交互 功能 和 后 台 的 数据 管理 .网 络 通信 等 程 
序 功能 。 通 过 Java 源 程序 代码 ,把 UI 设计 的 用 户 界面 按照 应 用 逻辑 关联 起 来 ,实现 整个 
App 的 完整 功能 。 在 开发 阶段 ,需要 进行 每 个 Java 源 程序 的 编写 .调试 和 运行 。 

AndroidManifest. xml 文件 是 对 App 总 体 进 行 配置 的 文件 ,在 Java 应 用 程序 开发 的 
过 程 中 ,每 一 个 Android 组 件 都 需要 在 这 个 文件 中 进行 配置 后 ,才能 够 添加 到 App 中 执行 。 
AndroidManifest xml 中 还 需要 进行 其 他 的 一 些 设置 ,具体 的 内 容 可 以 参照 1. 4.2 节 。 

3. 调试 和 测试 

这 个 阶段 ,其 中 一 个 重点 是 配置 Build 的 模式 ,进行 软件 测试 , 即 是 对 App 进行 总 体 
Build 调试 和 测试 ,可 以 按照 软件 的 测试 标准 ,书写 测试 用 例 ,查找 软件 的 中 bug ,对 软件 
的 功能 和 性 能 进行 测试 ,优化 App。 

另 一 个 重点 是 在 不 同 配置 的 AVD 上 和 硬件 设备 上 对 App 进行 功能 和 性 能 测试 ,对 
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其 兼容 性 和 健壮 性 进行 测试 ,调整 App 的 用 户 界面 友好 程度 和 增强 App 的 版 本 兼容 性。 

这 些 调试 和 测试 过 程 , Android Studio 都 提供 有 相应 工具 来 帮助 程序 员 进 行 ,具体 的 
使 用 可 以 参考 Android Studio 的 手册 。 

4. 发 布 

发 布 是 把 开发 完成 的 App 提供 给 用 户 的 过 程 。 这 个 过 程 需 要 完成 两 个 任务 : 准备 
发 布 的 App 和 在 网 络 上 发 布 App。 


1.5.2 Android 关键 组 件 


Android App 都 是 由 Android 组 件 搭 建 而 成 的 。 在 众多 的 组 件 中 ,关键 的 基本 组 件 
有 四 种 : Activity, Service, ContentProvider, BroadcastReceivers, Android App 根据 自身 的 功 
能 需求 ,使 用 其 中 一 种 或 多 种 组 件 。 在 这 里 简单 介绍 这 些 组 件 ,对 其 功能 有 所 了 解 。 

在 有 的 资料 或 书籍 中 ,把 这 些 组 件 的 英文 名 称 翻 译 成 相应 的 中 文 名 称 ,但 因为 在 程序 
设计 和 源 程序 代码 编写 中 ,都 是 直接 使 用 这 些 组 件 的 子 类 ,所 以 本 书 中 在 提 到 这 些 组 件 
时 ,直接 使 用 英文 名 称 ,方便 大 家 理解 和 记忆 ,不 再 进行 转换 。 

Activity 是 一 种 关键 的 执行 组 件 ,为 用 户 操作 而 展示 的 可 视 化 用 户 界面 。 在 App 中 
至 少 需要 一 个 Activity 作为 UI 界面 ,所 有 的 Activity 都 是 从 Activity 类 继承 而 来 。 对 于 
App 来 说 ,Activity 是 程序 的 入口 ,相当 于 C/C++ 中 的 main()。 例 如 ,照相 机 App 可 能 
有 一 个 Activity 显示 一 个 聚焦 或 拍照 的 可 视 化 界面 ,也 能 启动 另 一 个 Activity 来 管理 和 
像 是 所 拍 的 照片 。App 中 的 每 一 个 Activity 都 是 独立 的 ,但 可 以 相互 转换 。 

Service 主要 用 于 实现 一 种 需要 长 时 间 执 行 、 不 需要 用 户 界面 的 后 台 操 作 。 所 有 的 
Service 都 是 Service 的 子 类 ,可 以 由 另 一 个 的 应 用 组 件 启动 。 

ContentProvider 是 App 的 共享 数据 处 理 组 件 ,提供 自己 的 数据 给 外 部 应 用 程序 使 
用 ,提供 的 数据 可 以 存储 为 Android 文件 .SQLite 数据 库 文件 或 其 他 合法 格式 。 它 主要 
应 用 于 不 同 的 应 用 程序 之 间 进 行 数据 共享 ,如 果 某 一 应 用 程序 需要 使 用 其 他 应 用 程序 的 
数据 ,就 必须 采用 ContentProvider 对 象 。 

在 Android 的 系统 中 系统 会 发 送 的 广播 通知 ,例如 电池 电量 过 低 或 者 信号 过 低 ,其 他 
Android 组 件 也 会 发 送 广 播 消 息 。BroadcastReceiver 是 负责 接收 广播 消息 并 对 消息 做 出 
反应 的 组 件 。 如 果 在 一 个 App 中 需要 接收 某 种 广播 消息 并 进行 处 理 , 就 可 以 定义 一 个 
BroadcastReceiver 的 子 类 。BroadcastReceiver 不 会 与 UI 交互 。 但 一 般 来 说 , 当 广 播 事 
件 发 生 时 ,会 创建 一 个 状态 条 通知 来 提醒 用 户 。 


1.6 本 章 小 结 


本 章 首先 简单 介绍 了 Android 的 概念 和 Android 系统 的 技术 架构 ;然后 详细 介绍 了 
Android 开发 环境 Android Studio 在 不 同 操作 系统 中 安装 和 配置 的 具体 步骤 ,使 用 
HelloWorld App 说 明了 在 Android Studio 中 App 开发 和 运行 过 程 ,着 重 介 绍 了 App 在 
硬件 设备 和 AVD 上 运行 时 配置 的 过 程 ; 在 最 后 两 节 , 简 单 介 绍 了 Android Studio 的 使 用 
和 Android App 的 开发 流程 。 


设计 应 用 界面 


每 个 Android 客户 端 应 用 首先 面 对 的 就 是 界面 的 开发 。Android 系统 提供 了 丰富 的 
界面 控件 。Android 提供 的 用 户 图 形 交互 界面 称 为 Activity。 本 章 主 要 介绍 Activity 的 
基本 知识 和 使 用 方法 ,如 何在 Activity 上 实现 不 同 的 布局 ,如 何 理 解 字符 串 、 图 片 等 资源 
的 使 用 。 


2.1 理解 Activity 


Activity 是 Android 的 四 大 基本 组 件 之 一 。 通 过 Activity ,用户 可 以 与 移动 终端 进行 
交互 ,使 用 Android 应 用 程序 做 一 些 事情 ,如 拨打 电话 、 拍 照 \ 发 送 电 子 邮 件 或 查看 地 图 
等 。Activity 也 可 以 看 作 是 一 个 特定 的 窗口 ,输入 框 \ 按 钮 等 各 种 视图 控件 能 够 在 其 中 按 
需求 进行 不 同 的 排列 。 这 种 窗口 通常 填 满 整个 屏幕 ,但 可 能 会 小 于 屏幕 或 者 浮 在 其 他 窗 
口 之 上 ,例如 对 话 框 。 

所 有 的 Activity 都 是 从 Android 提供 的 类 Activity 继承 而 来 。 一 个 应 用 程序 通常 由 
一 个 或 多 个 Activity 组 成 。 

在 应 用 程序 中 ,通常 指定 一 个 主 Activity, 它 是 应 用 程序 启动 时 ,首先 呈现 给 用 户 的 
界面 。App 通过 主 Activity ,根据 不 同 功能 启动 其 他 的 Activity。 这 些 Activity 之 间 根 据 
应 用 程序 的 逻辑 功能 可 以 实现 相互 调用 启动 。 如 果 一 个 Activity 启动 了 另 一 个 
Activity, 则 自身 的 状态 发 生 改变 ,处 于 stopped( 停 止 ) 状 态 ,新 的 Activity 接替 它 成 为 用 
户 可 操作 的 界面 。 通 常情 况 下 ,一 个 App 不 会 将 所 有 的 功能 在 一 个 Activity 中 实现 。 

在 第 1 章 编写 第 一 个 Android 应 用 程序 显示 “Hello World!1” 时 ,用 到 了 Activity, F 
面 来 讨论 创建 和 使 用 Activity 的 基本 过 程 , 了 解 Activity 在 用 户 操作 过 程 中 呈现 的 状态 
和 各 种 状态 的 转换 过 程 ,以 及 对 应 的 系统 回调 方法 。 


2.1.1 创建 可 运行 的 Activity 


要 创建 在 Android 应 用 程序 中 可 运行 的 Activity, 必 须要 实现 四 个 任务 : 
(1) 命名 并 定义 Activity 的 子 类 。 

(2) 设计 和 实现 用 户 界面 。 

(3) 在 Manifest 文件 中 声明 这 个 Activity。 

(4) 测试 运行 。 
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1. 命名 并 定义 Activity 的 子 类 

要 创建 一 个 用 户 界面 Activity, 必 须 定义 一 个 子 类 来 继承 Activity, 并 根据 界面 的 功 
能 和 状态 变化 ,在 其 回调 方法 中 编写 相应 的 代码 。 

在 Android 定义 Activity 组 件 时 ,针对 用 户 界面 的 不 同 状态 变化 ,为 其 定义 了 一 系列 
不 同 的 回调 方法 。 例 如 用 户 界 面 创 建 、 改 变 、 恢 复 或 销毁 的 动作 ,都 对 应 Activity 中 不 同 
的 回调 方法 。 所 谓 回 调 方法 ,就 是 在 Activity 状态 变化 时 ,Android 系统 会 自动 调用 在 
Activity 中 预先 定义 的 对 应 方法 ,执行 其 中 的 代码 。 因 为 是 系统 反 向 调用 子 类 中 定义 方 
法 ,实现 其 功能 ,所 以 称 为 回调 。 因 此 定义 子 类 时 ,可 以 在 回调 方法 中 定义 需要 的 功能 , 系 
统 就 可 以 在 用 户 界面 状态 变化 时 ,调用 应 用 程序 中 Activity 的 对 应 回调 方法 ,来 实现 其 功 
能 。 例 如 , 某 个 Activity 需要 在 界面 恢复 时 重新 读 取 数 据 库 的 信息 ,就 可 以 在 此 Activity 
的 onResume() 回 调 方法 中 定义 重新 读 取 数 据 库 的 操作 。 这 样 , 当 这 个 Activity 界面 恢复 
时 ,系统 就 会 自动 调用 它 的 onResume() ,运行 里 面 定义 的 代码 ,实现 其 功能 。 

在 Activity 的 回调 方法 中 ,有 两 个 最 重要 的 回调 方法 onCreate() 和 onPause() 。 

1) onCreate() 

在 系统 创建 Activity 时 ,第 一 个 调用 这 个 方法 ,并 且 执 行 其 中 的 代码 ,因此 必须 实现 
这 个 方法 。 这 部 分 代码 主要 是 进行 变量 的 初始 化 ,完成 Activity 的 初始 化 ,其 中 最 主要 的 
是 必须 调用 setContentView() 方 法 ,为 Activity 的 用 户 界面 定义 布局 ,就 是 初始 化 显示 
界面 。 

一 旦 onCreate() 方 法 调用 完成 后 , Activity 的 状态 不 会 停留 在 Created, 系统 会 立刻 
接着 调用 Acitivity 的 另 两 个 回调 方法 onStart() 方 法 和 onResume() 方法 ,Activity 的 状 
态 很 快 会 进入 到 Active 状态 ,也 就 是 运行 状态 。 

2) onPause() 

当 用 户 离开 当前 的 Activiy 时 ,系统 调用 此 方法 。 

下 面 为 了 讨论 Activity 的 创建 ,使 用 和 状态 ,在 Android Studio 建立 一 个 新 的 App 
项 目 ,命名 为 C02ActivityLifecycle, 主 Activity 命名 为 MainActivity, Company Domain 
定义 为 uibe. edu. cn, 并 按照 1. 3. 5 节 中 创建 Activity 的 步骤 ,创建 另外 两 个 类 
DialogActivity 和 ImageActivity ,注意 将 它们 的 父 类 都 改 为 Activity。 在 这 个 App 中 将 
实现 从 MainActivity 分 别 到 DialogActivity 和 ImageActivity 两 个 界面 的 转换 和 返回 。 

在 完成 Activity 初步 创建 之 后 ,就 进行 下 一 步 ,根据 App 的 功能 设计 和 实现 用 户 
界面 。 

2. 设计 和 实现 用 户 界面 

Android 为 程序 员 提供 了 三 种 用 户 界面 设计 的 方法 : Java 代码 “编程 式 ” 设 计 实 现 、 
XML 文件 编写 设计 和 图 形 化 界面 设计 。 

如 果 使 用 Java 代码 直接 在 源 代码 中 构建 应 用 程序 的 用 户 界面 ,在 编写 代码 过 程 中 必 
须 对 界面 的 层次 关系 十 分 清晰 ,并 逐个 定义 这 些 用 户 图 形 界面 组 件 的 属性 和 关系 ,这 在 界 
面 比较 复杂 ,组件 比 较 多 时 ,对 程序 员 是 一 个 考验 。 在 界面 美观 ,组 件 排列 合理 组 件 位 置 
微调 、 风 格 统一 等 细节 方面 可 能 会 耗费 程序 员 较 多 的 时 间 ,可 能 比 预计 的 时 间 多 得 多 。 这 
种 方式 对 于 界面 的 开发 是 很 不 方便 的 ,因为 一 些小 的 布局 变化 都 有 可 能 导致 对 源 代 码 的 
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修改 ,并 且 需 要 重新 编译 。 因 此 这 种 方法 ,在 Android 的 用 户 图 形 界面 设计 中 并 不 推荐 。 

设计 实现 用 户 界 面 的 第 二 种 方法 ,XML 文件 编写 设计 ,是 使 用 Android Studio 的 
XML 文件 编辑 器 打开 Activity 对 应 的 XML 布局 文件 ,在 文件 中 编写 代码 ,来 描述 界面 
的 布局 控件 和 相关 的 属性 。 在 1. 3. 4 节 中 使 用 的 就 是 这 种 方法 。 由 于 XML 文件 是 一 
个 层次 化 结构 的 文件 ,因此 布局 和 控件 的 关系 十 分 清楚 ,语法 比较 简单 。 而 且 组 件 的 标 
识 、 属 性 和 位 置 的 设置 集中 在 一 起 ,布局 和 控件 不 涉及 应 用 程序 的 逻辑 ,只 是 单纯 的 排列 
和 设计 ,也 就 能 很 方便 ,快速 地 完成 用 户 界面 的 布局 ,修改 起 来 也 很 容易 定位 。 缺 点 是 在 
界面 比较 复杂 组件 比 较 多 时 也 很 难 兼顾 美观 ,如 果 只 能 在 Activity 运行 时 才能 看 到 效 
果 , 调 整 起 来 同样 也 很 耗费 时 间 。 

图 形 化 界面 设计 是 使 用 Android Studio 提供 的 图 形 化 界面 设计 工具 ,能 够 把 工具 提 
供 的 布局 和 控件 直接 拖 忠 到 手机 界面 上 合适 的 位 置 ,直观 地 显示 出 来 ,并 且 通 过 属性 设置 
界面 ,直接 设置 组 件 的 属性 。 在 设计 过 程 中 , 随 着 布局 和 控件 的 添加 、 属 性 的 修改 ,XML 
布局 文件 的 代码 也 自动 生成 。 使 用 第 二 种 方法 直接 编写 代码 的 XML 布局 文件 ,也 可 以 
通过 图 形 化 界面 设计 的 手机 的 模拟 界面 ,直观 地 看 到 实际 显示 效果 。 

如 果 要 使 用 Android Studio 的 图 形 化 界面 设计 工具 ,首先 打开 需要 设计 的 XML 布 
局 文件 ,然后 单 击 图 2. 1 左下 角 箭 头 指向 标注 的 Design 标签 ,就 可 以 看 到 手机 模拟 界面 
的 窗口 了 。 下 面 以 MainActivity 的 界面 设计 为 例 , 详 细 描述 如 何 使 用 这 个 工具 进行 界面 
设计 。 

1) 打开 XML 布局 文件 的 Design 界面 

在 这 个 例子 中 ,首先 双击 打开 MainActivity 对 应 的 布局 文件 activity_main. xml, 单 
i Design 标签 ,进入 图 形 化 设计 。 然 后 在 手机 模拟 界面 上 ,选中 已 有 的 Hello World! X 
本 框 ,删除 这 个 组 件 ,准备 好 空白 屏幕 ,为 添加 自己 的 布局 和 控件 做 准备 。 

2) 从 Palette 拖 电 组 件 到 手机 屏幕 

图 2.1 中 左上 和 角 箭 头 指向 标注 的 Palette 窗口 中 , 列 出 了 Layouts, Widgets, 
TextFields 和 Containers 等 布局 和 控件 。 在 Palette 窗口 中 , 拖 动 Widgets 中 的 Large 
Text 放置 到 手机 屏幕 的 顶部 。 在 组 件 放 置 过 程 中 ,会 有 位 置 线 辅 助 。 这 时 可 以 在 图 2. 1 
中 右上 和 角 箭 头 指 向 标注 的 ComponentTree 窗口 中 ,看 到 Device Screen 的 分 支 
RelativeLayout 的 下 面 出 现 了 名 为 TextView 的 控件 。 

接 下 来 , 拖 动 Containers 中 的 ScrollView 放置 到 屏幕 中 Large Text 的 下 方 ;再 拖 动 
Widgets 中 的 Medium Text 放置 到 ComponentTree 窗口 的 ScrollView 组 件 上 ,让 这 个 
TextView 成 为 ScrollVeiw 组 件 的 分 支 。 

3) 修改 组 件 的 属性 

图 2.1 中 右 下 角 箭 头 指向 标注 的 Properties 窗口 ,是 布局 和 控件 的 属性 设置 窗口 。 
在 这 个 窗口 中 列 出 了 布局 和 控件 所 能 设置 的 所 有 属性 。 单 击 属性 对 应 的 一 栏 , 就 可 以 根 
据 设 计 给 予 不 同 的 赋值 或 选择 。 通 常情 况 下 , id, text, layoutwidth、 layoutheight、 
background、onClick 等 属性 是 经 常 需要 设置 的 属性 。 

例如 ,在 这 里 ScrollView 的 layoutwidth 设置 成 fill_parent, layoutheight 设置 成 
200dp ,使 其 宽度 和 屏幕 宽度 一 致 ,高 度 设置 成 200dp, 容纳 其 分 支 Text View 显示 的 内 
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图 2.1 用 户 界面 图 形 设 计 工 具 


容 。 为 了 突出 显示 的 信息 ,其 background 设置 成 highlighted_text_material_dark 


继续 拖 动 Widgets 中 的 Button ,为 屏幕 中 的 ScrollView 添加 两 个 Button。 修 改 前 一 
个 Button 的 属性 ,id 为 btn_dialog, text 为 Dailog,onClick 设 定 其 单 击 事件 处 理 的 方法 为 
startDialog; 修 改 后 一 个 Button 的 属性 ,id 为 btn_image, text 为 Picture,onClick 设 定 其 


单 击 事件 处 理 的 方法 为 startImage。 


图 形 化 设计 完成 后 , 单 击 Design 旁边 的 Text 标签 ,可 以 查看 对 应 的 XML 文件 的 文 
本 形式 代码 ,对 一 些 细节 进行 调整 和 补充 。 单 击 Design 标签 和 Text 标签 可 以 使 布局 文 
件 在 图 形 形 式 和 文本 代码 形式 之 间 转 换 。 综 合 使 用 图 形 化 设计 和 XML 代码 编写 ,是 一 


种 效率 相对 较 高 的 设计 方式 。 
4) 对 布局 和 控件 的 事件 进行 处 理 


根据 上 面 对 onClick 属性 的 设置 ,在 MainActivity. java 代码 中 添加 按钮 的 事件 处 理 


代码 ( 见 代码 2. 1) ,实现 启动 另 一 个 对 应 的 Activity, 
代码 2.1 启动 另 一 个 Actiivity 


// 处 理 单 击 Dialog 按钮 事件 ,启动 DialogActivity 


public void startDialog (View v) { 


Intent intent=new Intent (MainActivity.this, DialogActivity.class); 


startActivity(intent); 
) 


// 处 理 单 击 Pictures 按钮 事件 ,启动 Imageactivity 


public void startImage (View v) { 
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Intent intent=new Intent (MainActivity.this, ImageActivity.class); 
startActivity(intent); 
li 


到 此 ,MainActivity 的 设计 基本 完成 。 在 图 形 化 设计 过 程 中 ,也 可 以 通过 单 击 组 件 提 
示 完 成 strings. xml 的 设置 ,使 用 喜欢 的 图 片 作 为 整个 Activity 的 背景 ,或 尝试 改变 其 他 
的 属性 ,实现 自己 的 个 性 化 设计 。 

另外 ,通过 MainActivity 启动 的 DialogActivity 和 ImageActivity 界面 的 设计 如 图 2. 2 
所 示 。 左 图 是 activity _ dialog. xml 的 图 形 化 设计 结果 , 其 中 RelativeLayout 的 
layoutwidth 值 为 225dp,layoutheight 值 为 120dp ,背景 background 设置 为 holo_orange_ 
light ,按钮 btn_close 的 onClick 属性 设 定 其 单 击 事件 处 理 的 方法 为 closeDialog; 右 图 是 
actiivty_image. xml 的 图 形 化 设计 结果 ,其 中 ImageView 对 象 的 background 使 用 了 res/ 
drawables 中 的 自 定义 图 片 ,按钮 btn_image_close 的 onClick 属性 设 定 其 单 击 事件 处 理 
的 方法 为 closeImage()。 
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图 2.2 DialogActivity 和 ImageActivty 界面 设计 


这 两 个 Activity 的 事件 处 理 很 简单 ,也 非常 类 似 , 都 是 关闭 自身 的 Activity。 具 体 代 
码 可 以 参考 代码 2.2 中 的 closeDialog() 方 法 。 
代码 2.2 DialogActivity. java 


public class DialogActivity extends Activity { 


@override 

protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
requestWindowFeature (Window.FEATURE NO TITLE); 
setContentView(R.layout.activity_dialog); 


public void closeDialog (View v) { 
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DialogActivity.this.finish(); 
} 


3. 在 Manifest 文件 中 声明 Activity 

每 个 Android 应 用 程序 都 是 一 个 独立 的 Android 项 目 , 都 有 一 个 AndroidManifest. 
xml 文件 ,这 里 面 是 这 个 项 目 中 所 包含 的 组 件 和 应 用 程序 的 配置 说 明 。 在 创建 项 目 时 ， 
Android Studio 会 自动 创建 这 个 文件 。 将 新 定义 的 Activity 的 相关 参数 写 人 
AndroidManifest. xml 文件 的 过 程 , 称 为 Activity 的 声明 。 

Activity 只 有 在 AndroidManifest. xml 中 声明 后 ,才能 够 在 应 用 程序 调用 时 成 功 运 
行 ,系统 才 可 以 访问 到 它们 。 

要 声明 前 面 新 创建 的 DialogActivity 和 ImageActivity, 使 它们 可 以 在 App 启动 后 正 
常 执行 ,可 以 打开 Manifest 目录 下 的 AndroidManifest. xml 文件 ,添加 两 个 二 activity 二 
元 素 作 为 二 application 过 元 素 的 子 元 素 , 注 意 将 DialogActivity 的 主题 设置 成 Dialog, 见 
代码 2. 3。 

代码 2.3 添加 新 增 的 Activity 到 Manifest 文件 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="cn.edu.uibe.c02activitylifecycle"> 


<application 
<activity android:name=".MainActivity"> 
</activity> 


<activity 
android:name=".pDialogActivity" 
android:theme="@android:style/Theme.Dialog" /> 
<activity android:name=".ImageActivity" /> 
</application> 


</manifest> 


4. 运行 App 测试 Activity 功能 

完成 上 面 的 步骤 后 ,运行 App ,选择 AVD, 等 待 一 会 儿 , 就 会 看 到 图 2. 3 中 图 屏幕 显 
示 出 MainActivity 的 界面 效果 。 单 击 DIALOG 按钮 ,会 启动 DialogActivity 显示 出 左 图 
的 屏幕 , 单 击 PICTURES 按钮 ,会 启动 ImageActiivty 显示 出 右 图 的 屏幕 。 

由 于 MainActivity 中 还 没有 添加 显示 状态 转换 的 信息 ,在 中 图 屏幕 上 的 有 色 显 示 部 
分 还 只 能 看 到 默认 的 TextView 文本 。 当 完成 下 一 节 Activity 的 生命 周期 的 例子 后 ,就 
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可 以 看 到 图 示 的 信息 了 。 


Activity Status CozActivityifecycie 


The Beautiful Swan 





2.3 App 中 的 Activity 显示 效果 
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Android 平台 主要 是 为 移动 终端 开发 的 操作 系统 。 移 动 终端 的 特性 就 是 应 该 能 随时 
在 未 完成 当前 任务 的 时 候 , 切 换 到 其 他 任务 中 ,再 次 回来 以 后 还 可 以 继续 完成 刚才 没有 完 
成 的 任务 。 为 什么 设置 Activity 的 生命 周期 呢 ? 

先 看 一 个 典型 的 例子 : 在 编写 短信 时 ,有 一 个 紧急 电话 打 过 来 ,你 必须 要 接 这 个 电 
话 ,如 果 接 完 电话 后 ,你 肯定 希望 继续 编辑 刚才 的 短信 ,完成 这 个 任务 。 

为 了 完成 类 似 的 任务 ,Android 系统 需要 同时 执行 多 个 程序 。 但 对 于 移动 终端 这 种 
有 限 资源 的 平台 来 说 ,同时 执行 多 个 程序 可 以 提高 用 户 的 友好 性 ,但 是 也 有 它 的 严重 的 缺 
点 。 每 多 执行 一 个 应 用 程序 ,就 会 多 耗费 一 些 系统 内 存 。 手 机 里 的 内 存 是 相当 有 限 的 , 当 
同时 执行 的 程序 过 多 ,或 是 关闭 的 程序 没有 正确 释放 掉 内 存 ,执行 系统 时 就 会 觉得 越 来 越 
慢 ,甚至 不 稳定 。 为 了 解决 个 问题 ,Android 引入 了 生命 周期 的 机 制 来 管理 应 用 程序 , 见 
图 2.4。 

Android 应 用 程序 的 生命 周期 是 由 系统 框架 进行 管理 ,不 是 由 应 用 程序 直接 控制 ， 
Android 系统 的 Dalvik 虚拟 机 会 依照 内 存 状 况 和 Activity 的 使 用 状态 ,来 自动 管理 内 存 
的 使 用 。 

图 2.4 说 明了 Activity 生命 周期 中 各 个 状态 ,以 及 在 状态 转换 过 程 中 系统 会 调用 的 
方法 。Activity 状态 的 转换 是 由 于 用 户 的 操作 或 其 他 原因 引起 的 , 当 Activity 状态 发 生 
转换 时 ,相关 方法 中 的 代码 就 会 执行 。 例 如 在 Activity 创建 启动 时 ,会 依次 调用 其 
onCreate() .onStart() .onResume() 方 法 中 的 代码 ; 当 Activity 从 运行 状态 转换 成 暂停 状 
态 时 ,会 调用 其 onPause() 方 法 中 的 代码 。 
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图 2.4 Activity 的 生命 周期 





Activity 的 生命 周期 中 有 四 种 状态 : 


Active/Running: 在 屏幕 的 前 台 , 叫 做 活动 状态 或 者 运行 状态 (Active or 
Running) 。 

Paused: 如 果 一 个 Activity 失去 焦点 ,但 是 依然 可 见 ( 一 个 新 的 非 全 屏 的 Activity 
或 者 一 个 透明 的 Activity 被 放置 在 栈 顶 ) ,叫做 暂停 状态 (Paused)。 一 个 暂停 状 
态 的 Activity 依然 保持 活力 (保持 所 有 的 状态 、 成 员 信息 ,和 窗口 管理 器 保持 连 
接 ) ,但 是 在 系统 内 存 极端 低下 的 时 候 将 被 杀 掉 。 

Stopped: 如 果 一 个 Activity 被 另外 的 Activity 完全 覆盖 掉 , 叫做 停止 状态 
(Stopped) 。 它 依然 保持 所 有 状态 和 成 员 信息 ,但 是 它 不 再 可 见 , 所 以 它 的 窗口 被 
隐藏 , 当 系 统 内 存 需 要 被 用 在 其 他 地 方 的 时 候 ,Stopped 的 Activity 将 被 杀 掉 。 
Killed: 如 果 一 个 Activity 是 Paused 或 者 Stopped 状态 ,系统 可 以 将 该 Activity 
从 内 存 中 删除 ,Android 系统 采用 两 种 方式 进行 删除 : 要 么 要 求 该 Activity 结束 ， 
要 么 直接 杀 掉 它 的 进程 。 当 该 Activity 再 次 显示 给 用 户 时 , 它 必 须 重新 开始 和 重 
置 前 面 的 状态 。 


1 

1 

1 

DonCreate() 1 

Created 

onRestart() | 

' 

' 

' 

' 

' 
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Activity 的 生命 周期 中 有 三 个 关键 的 循环 , 见 图 2.5。 
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图 2.5 Activity 的 状态 转换 


。 整个 的 生命 周期 。 从 onCreate 开始 到 onDestroy() 结 束 。Activity 在 onCreate() 
设置 所 有 的 “全 局 ”状态 ,在 onDestory() 释 放 所 有 的 资源 。 例 如 : 某 个 Activity 
有 一 个 在 后 台 运 行 的 线程 ,用 于 从 网 络 下 载 数据 , 则 该 Activity 可 以 在 onCreate() 
中 创建 线程 ,在 onDestory() 中 停止 线程 。 

可 见 的 生命 周期 。 从 onStart() 开始 到 onStop() 结 束 。 在 这 段 时 间 , 可 以 看 到 
Activity 在 屏幕 上 ,尽管 有 可 能 不 在 前 台 , 不 能 和 用 户 交 互 。 在 这 两 个 接口 之 间 ， 
需要 保持 显示 给 用 户 的 界面 数据 和 资源 等 ,例如 : 可 以 在 onStart() 中 注册 一 个 
IntentReceiver 来 监听 数据 变化 导致 界面 的 变动 , 当 不 再 需要 显示 的 时 候 , 可 以 在 
onStop() 中 注销 它 。onStart() .onStop() 都 可 以 被 多 次 调用 ,因为 Activity 随时 
可 以 在 可 见 和 隐藏 之 间 转 换 。 

前 台 的 生命 周期 。 从 onResume() 开 始 到 onPause() 结 束 。 在 这 段 时 间 里 ,该 
Activity 处 于 所 有 Activity 的 最 前 面 , 和 用 户 进行 交互 。Activity 可 以 经 常 性 地 
在 Resumed 和 Paused 状态 之 间 切 换 , 例 如 : 当 设 备 准 备 休 眠 时 , 当 一 个 Activity 
处 理 结果 被 分 发 时 , 当 一 个 新 的 Intent 被 分 发 时 。 所 以 在 这 些 接口 方法 中 的 代码 
应 该 属于 非常 轻 量 级 的 。 


Activity 的 整个 生命 周期 的 状态 转换 和 动作 都 定义 在 的 回调 方法 中 ,所 有 方法 都 可 


以 被 重 写 , 见 代码 2. 4。 


代码 2.4 Activity 的 回调 方法 


public class Activity extends ApplicationContext { 
protected void onCreate (Bundle icicle); 
protected void onStart (); 
protected void onRestart (); 
protected void onResume () ; 
protected void onPause () ; 
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下 面 继续 上 一 小 节 的 例子 ,在 MainActivity 中 重 写 Acticity 所 有 的 回调 方法 ,在 
ScrollView 中 的 TextView 内 显示 自己 在 各 种 状态 转换 时 ,调用 了 哪些 不 同 回调 方法 。 
然后 可 以 根据 所 调用 的 回调 方法 ,参考 图 2. 5, 确 认 Activity 在 哪些 状态 之 间 进 行 了 转 
换 , 何 时 是 何 种 状态 。 代 码 2. 5 是 MainActivity 最 终 完整 的 代码 。 

代码 2.5 MainActivity. java 
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一 个 应 用 程序 通常 包含 多 个 Activity。 每 个 Activity 都 可 以 设计 完成 特定 的 用 户 操 
作 , 并 且 能 够 启动 其 他 Activity。 例 如 ,一 个 电子 邮件 的 应 用 程序 可 能 有 一 个 Activity, 用 
于 展现 出 新 的 电子 邮件 列表 , 当 用 户 选择 了 一 个 电子 邮件 ,就 打开 一 个 新 的 Activity 以 查 
看 该 电子 邮件 的 详细 内 容 。 

一 个 Activity 也 可 以 启动 设备 上 的 另 一 应 用 程序 中 的 Activity。 例 如 ,如 果 我 们 的 
应 用 程序 想 要 发 送 一 个 电子 邮件 ,可 以 把 邮件 地 址 和 内 容 等 信息 打包 在 一 个 称 为 Intent 
的 组 件 中 ,设置 启动 Email 应 用 程序 的 “创建 邮件 ”Activity, 并 获取 Intent 中 传递 的 信息 。 
当 邮 件 被 发 送 后 ,Activity 则 重新 展现 ,而 用 户 的 感觉 是 发 送 邮件 的 功能 好 像 是 应 用 程序 
的 一 部 分 。 虽 然 上 述 完 成 的 动作 来 自 不 同 的 应 用 程序 ,但 是 Android 系统 将 这 些 
Activity 放 人 到 相同 的 任务 中 ,这样 就 维护 了 一 个 完整 的 用 户 体验 。 

所 谓 任务 ,就 是 某 些 参 与 用 户 交互 的 Activity 集合 ,其 目的 是 为 完成 某 项 确定 的 工 
作 。Android 系统 通过 栈 结 构 来 管理 任务 中 的 这 些 Activity, Activity 按照 被 打开 的 顺 
序 排列 在 栈 中 。 

设备 的 主 (Home) 屏 幕 是 大 多 数 任务 的 起 点 。 当 用 户 触摸 应 用 程序 的 图 标 ( 或 者 主 
屏幕 上 的 快捷 方式 ) 时 ,该 应 用 程序 的 任务 就 会 来 到 前 台 。 如 果 该 应 用 的 任务 不 存在 ( 即 
应 用 在 最 近 时 间 段 内 没有 使 用 过 ) ,那么 一 个 新 的 任务 被 创建 ,应 用 的 主 Activity 会 作为 
栈 中 的 根 Activity 打开 。 

如 果 用 户 从 当前 的 Activity 打开 了 一 个 新 的 Activity, 则 新 的 Activity 被 压 人 到 栈 的 
顶部 ,并 且 成 为 用 户 的 前 端 界面 。 而 原来 的 Activity 仍然 在 栈 中 ,但 是 已 经 变 成 停止 状 
态 , 此 时 系统 会 保留 其 用 户 界 面 的 状态 。 当 用 户 按 下 返回 按钮 时 ,当前 的 Activity 就 会 从 
栈 的 顶部 弹出 ( 即 当前 的 Activity 就 会 被 销毁 ) ,而 原来 的 Activity 就 会 被 重新 恢复 显示 
(其 界面 的 状态 被 系统 保存 )。 在 栈 中 的 Activity 永远 不 会 被 重 排 ,只 有 压 人 和 弹出 操作 。 
这 种 栈 的 读 写 方式 为 “后 进 先 出 ” ,我们 称 其 为 回 退 栈 。 图 2. 6 展示 了 多 个 Activity 切换 
的 过 程 。 
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图 2.6 Activity 的 回 退 栈 














如 果 用 户 不 停 地 按 返回 键 的 时 候 , 那 么 栈 中 每 个 Activity 都 会 依次 弹出 ,并 显示 之 前 


的 Aetivity, 直 至 用 户 回 到 主屏 幕 (或 者 当 任 务 启动 时 的 任何 一 个 Activity)。 当 所 有 的 
Activity 都 从 栈 中 弹出 后 ,这 个 任务 就 不 再 存在 。 
一 个 任务 就 是 一 个 完整 的 单元 , 当 用 户 启 
动 一 个 新 的 任务 时 或 者 使 用 Home 按钮 回 到 “|| Foreground activity Packeround 
Home 屏幕 的 时 候 , 这 个 任务 就 会 转变 为 后 台 。 Activity z L Avi Y J 
当 任务 处 于 后 台 时 ,里 面 所 有 的 Activity 都 处 

















Activity X 
于 停止 状态 ,但 是 这 个 任务 的 回 退 栈 仍然 被 完 EEA 
整 保留 。 当 其 他 任务 变 成 前 台 时 ,当前 的 任务 Te UV 
就 变 成 后 台 , 见 图 2.7。 图 2.7 任务 的 前 台 与 后 台 


任务 可 以 回 到 前 台 , 以 便 用 户 继续 之 前 的 
操作 。 例 如 ,当前 任务 A 共有 两 个 Activity 在 栈 中 ,这 时 用 户 按 下 Home 键 切换 到 主屏 
幕 , 然 后 启动 一 个 新 的 应 用 程序 。 当 主屏 幕 显示 时 ,任务 A 进入 后 台 ; 而 当 新 的 应 用 程序 
启动 时 ,系统 会 为 他 开启 一 个 新 的 任务 B, 其 拥有 自己 的 回 退 栈 。 如 果 用 户 使 用 这 个 应 用 
后 ,用 户 使 用 Home 键 再 次 切换 到 主屏 幕 ,并 且 选 中 那个 启动 任务 A 的 应 用 程序 。 此 时 ， 
任务 A 进入 前 台 ,而 其 栈 中 的 两 个 Activity 仍然 被 完整 保留 ,并 且 位 于 栈 顶 的 Activity 
重新 恢复 显示 。 此 时 ,用 户 仍然 可 以 从 主屏 幕 切 换 到 启动 任务 B 的 应 用 程序 。 这 也 是 
Android 系统 中 多 任务 的 例子 。 

虽然 Android 系统 可 以 在 后 台 同 时 保留 多 个 任务 ,但 是 假如 用 户 同 时 运行 着 多 个 后 
台 任务 时 ,系统 可 能 会 销毁 后 台 Activity 用 于 释放 内 存 , 这 样 的 情况 就 会 导致 Activity AR 
态 的 丢失 。 


2.2 理解 布局 


前 一 节 我 们 对 Activity 有 了 初步 的 了 解 和 理解 ,也 在 具体 的 例子 中 运用 到 了 
Actiivty 的 布局 与 控件 。 从 继承 的 概念 上 来 说 , Activity 中 具体 用 户 图 形 界面 的 组 件 由 
Android 定义 的 View 类 和 ViewGroup 类 的 子 类 对 象 组 成 ,我 们 把 它们 称 为 View 和 
ViewGroup 对 象 。 

View 对 象 是 Android 平台 上 用 户 界面 中 的 基础 单元 ,也 可 称 为 控件 。Android 系统 
提供 了 许多 类 型 的 View, 例 如 TextView 和 Button 等 类 ,它们 都 是 View 类 的 子 类 。 

ViewGroup 对 象 可 以 理解 为 一 种 容器 ,类 似 于 Java 中 的 Panel, 用 于 容纳 其 他 的 控件 
对 象 ,并 规定 这 些 控件 对 象 按照 特定 的 规则 进行 排列 , 即 按照 某 种 层次 结构 排列 。 
Android 系统 也 提供 了 许多 类 型 的 ViewGroup, 例如 ScrollView, RelativeLayout 和 
TabHost 等 ,它们 都 是 ViewGroup 的 子 类 。 

那么 什么 是 布局 呢 ? View 和 ViewGroup 对 象 在 Activity 中 的 排列 层次 结构 , 称 为 
用 户 界面 的 布局 。 最 常用 的 是 线性 布局 LinearLayout、 表 格 布局 TableLayout、 相 对 布局 
RelativeLayout、 网 页 布局 WebView 和 列表 ListView 等 。 

在 Android 平台 ,一 个 Activity 的 用 户 界面 能 够 使 用 层次 关系 的 View 和 
ViewGroup 对 象 组 合 来 设计 布局 ,例如 图 2. 8。 
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在 第 1 章 我 们 提 到 过 ,Android 系统 实现 Activity 的 用 户 界面 布局 有 两 种 定义 方式 ， 
| 一 种 是 使 用 XML 文件 定义 布局 ,把 布局 文件 时 

于 /res/layout 目录 下 ; 另 一 种 是 在 Java 应 用 程序 

中 通过 编程 的 方法 来 创建 View 和 ViewGroup 
(visoon) [view] [viw] 对 象 ,在 运行 时 实例 化 布局 元 素 ,或 改变 其 属性 。 
Android 的 XML 布局 资源 文件 主要 用 于 















































View View View Activity 用 户 界面 或 其 他 的 用 户 界面 组 件 的 布 
图 2.8 Viw 和 ViewGrop 对 象 。 局。 使 用 XML 布局 文件 的 优势 除了 在 前 面 提 到 
uda 的 外 ,最 重要 的 是 可 以 将 应 用 程序 的 界面 设计 与 


控制 逻辑 分 离开 来 ,这 更 有 利于 用 户 屏幕 不 确 

定 的 移动 应 用 。 如 果 需 要 调整 界面 设计 ,只 需要 修改 XML 文件 ,而 无 须 修改 源 代码 并 
重新 编译 。 例 如 ,对 于 不 同 移动 设备 或 用 户 、 不 同 的 屏幕 方向 不 同 的 屏幕 尺寸 .不 同 
的 语言 等 ,我 们 可 以 设计 不 同 XML 布局 文件 ,但 是 可 能 并 不 需要 修改 任何 应 用 程序 代 
码 。 此 外 ,对 于 一 个 初学 者 来 说 ,使 用 XML 布局 更 容易 定义 用 户 界面 的 结构 ,更 容易 
进行 调试 。 

这 一 节 系 统 地 介绍 如 何在 XML 布局 文件 中 使 用 XML 语言 ,来 设计 和 描述 用 户 图 形 
界面 。XML 布局 资源 文件 的 具体 语法 结构 见 代 码 2.6. 

代码 2.6 布局 资源 文件 的 语法 


<?xml version="1.0" encoding="utf-8"?> 
<ViewGroup xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@ [+] [package:]id/resource name" 
android:layout height= ["dimension" | "fill parent" | "wrap_content"] 
android:layout width=["dimension" | "fill parent" | "wrap content"] 
[ViewGroup-specific attributes]> 
<View 
android:id="@ [+] [package:]id/resource name" 
android:layout height=["dimension" | "fill parent" | "wrap content"] 
android:layout width=["dimension" | "fill parent" | "wrap content"] 
[View- specific attributes]> 
<requestFocus/> 
</View> 
<ViewGroup> 
<View /> 
</ViewGroup> 
<include layout="@ layout/layout resource"/> 


</ViewGroup> 


Android 系统 的 布局 Layout 是 ViewGroup 的 子 类 ,根据 多 样 的 用 户 界 面 要 求 ， 
Android 系统 设计 了 多 种 的 不 同 的 布局 结构 ,例如 AbsoluteLayout、AdapterView 
<Textends Adapter œ>, CoordinatorLayout, DrawerLayout、 FragmentBreadCrumbs、 
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FrameLayout、 GridLayout、 LinearLayout、 LinearLayoutCompat、 PagerTitleStrip、 
Recycler View, RelativeLayout .SlidingDrawer, SlidingPaneLayout、 SwipeRefreshLayout、 
Toolbar, TvView, ViewPager 等 ,这 些 布 局 进行 不 同 的 组 合 嵌 套 , 则 能 提供 更 加 丰富 的 界 
面 布 局 。 

下 面 以 目前 最 常 使 用 的 基本 布局 线性 布局 .相对 布局 和 表格 布局 为 例 ,对 布局 设计 和 
使 用 进行 详细 描述 。 


2.2.1 线性 布局 LinearLayout 


线性 布局 是 基础 的 ,使 用 得 比较 多 的 布局 类 型 之 一 。 线 性 布局 的 作用 就 像 其 名 字 一 
样 ,根据 设置 的 垂直 或 水 平 的 属性 值 , 将 所 有 的 子 控件 按 垂 直 或 水 平方 向 进行 组 织 排列 。 
当 布局 方向 设置 为 垂直 时 ,布局 里 面 的 所 有 子 控件 被 组 织 在 同一 列 中 ; 当 布局 方向 设置 为 
水 平时 ,所 有 子 控件 被 组 织 在 一 行 中 ,设置 线性 布局 方向 的 属性 为 "android:orientation”， 
其 值 可 以 为 horizontal 或 vertical ,分 别 代表 水 平 或 垂直 方向 , 见 代码 2. 7。 

代码 2.7 LinearLayout 语法 格式 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="fill_parent" android:layout_height="wrap_content"> 


<!--add children here--> 


</LinearLayout> 


在 这 段 代 码 中 ,还 设置 了 android:layout_width 和 android:layout_height 属性 ,分 别 
代表 了 布局 的 宽度 和 高 度 , 这 两 个 属性 的 值 可 以 为 fill_parent, 其 代表 将 视图 扩展 以 填充 
所 在 容器 (也 就 是 父 容 器 ) 的 全 部 空间 。 还 可 以 使 用 android: gravity 属性 设置 布局 内 组 
件 的 对 齐 方式 ,其 值 可 以 为 top.buttom.left.right.center_vertical 等 。 

设置 边 距 布局 的 参数 有 layout_marginBottom layout_marginLeft, layout_marginRight 
和 layout_marginTop ,分 别 代表 离 某 元 素 底 边 缘 、 
左边 缘 、 右 边缘 和 顶 边缘 的 距离 。Android 的 
Margin 和 Padding 跟 HTML 的 是 一 样 的 , 见 n [E] -Margin 
图 2.9。 -Padding 

通俗 地 理解 Padding 为 内 边框 , Margin 为 外 
边框 ,代码 2.8 显示 了 如 何 设置 一 个 线性 布局 的 图 2.9 布局 划分 的 参数 定义 
边框 。 

代码 2.8 设置 LinearLayout 边框 


border 





























android:layout_marginBottom="25dip" 
android:layout_marginLeft="10dip" 
android:layout_marginTop="10dip" 


`e 
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android:layout marginRight="10dip" 
android:paddingLeft="1dip" 
android:paddingTop="ldip" 
android:paddingRight="1dip" 
android:paddingBottom="1dip" 


如 果 左 、 右 、 上 、 下 都 是 相同 的 设置 , 则 可 以 按照 如 下 代码 直接 设置 。 


android:layout marginBottom="25dip" 
android:layout margin="10dip" 
android:padding="5dip" 


LinearLayout 所 定义 的 界面 上 ,所 有 的 子 元 素 都 被 堆放 在 其 他 元 素 之 后 ,因此 一 个 
垂直 列表 的 每 一 行 只 会 有 一 个 元 素 ,而 一 个 水 平 列表 将 会 只 有 一 个 行 高 。 

LinearLayout 的 可 选 属性 layout_weight, 能 够 指定 
每 个 子 控件 在 父 级 线性 布局 中 的 相对 重要 程度 。 
LinearLayout 还 支持 为 单独 的 子 元 素 指 定 weight , X FË 
免 了 在 一 个 大 屏幕 中 一 串 小 对 象 挤 成 一 堆 的 情况 ,而 是 允 
许 它们 放大 填充 空白 。 子 元 素 指定 一 个 weight 值 , 剩 余 
的 空间 就 会 按 这 些 子 元 素 指定 的 weight 比例 分 配给 这 些 
子 元 素 。 默 认 的 weight 值 为 0。 例如 ,如 果 有 三 个 文本 
框 ,其 中 两 个 指定 了 weight 值 为 1 ,那么 ,这 两 个 文本 框 将 
等 比例 地 放大 ,并 填 满 剩余 的 空间 ,而 第 三 个 文本 框 不 会 
放大 , 见 图 2.10, 

mi SESMENAR 要 实现 这 个 界面 ,需要 下 面 几 个 步骤 ， 
A) 在 Android 项 目的 src 目录 下 ,创建 显示 界面 的 
LinearLayoutActivity 类 , 见 代 码 2.9。 

(2) 创建 布局 文件 linear_layout. xml, 存 放 在 /res/layout 目录 下 , 见 代 码 2.10, 

(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 LinearLayoutActivity 的 声明 , 见 
代码 2. 11。 

代码 2.9 LinearLayoutActivity. java 








public class LinearLayoutActivity extends Activity { 


@override 

protected void onCreate (Bundle savedInstanceState) ( 
//TODO Auto-generated method stub 
super.onCreate (savedInstanceState); 
setContentView(R.layout.linear layout); 


代码 2. 9 中 的 setContentView (R. layout. linear_layout) 表示 把 布局 文件 linear _ 
layout. xml 中 定义 的 控件 和 排列 显示 在 LinearLayoutActivity 定义 的 Activity 中 。 
代码 2. 10 linear_layout. xml 
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代码 2. 10 中 定义 了 三 个 线性 布局 。 外 层 的 线性 布局 ,通过 “android:orientation 一 
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"vertical"” 定 义 布局 内 的 空间 按 垂 直方 向 排列 。 这 个 外 层 布局 中 有 两 个 控件 ,分 别 是 设 
置 成 水 平方 向 和 设置 成 垂直 方向 的 两 个 线性 布局 ,第 一 个 线性 布局 中 是 4 个 设置 成 不 同 
颜色 的 TextView 控件 , 按 水 平方 向 排列 ;第 二 个 线性 布局 中 是 4 个 设置 成 " row one" 
不 同文 本 的 TextView , 按 垂 直方 向 排列 。 

完成 布局 文件 的 定义 后 ,就 可 以 在 AndroidManifest. xml 文件 中 添加 显示 这 个 界面 
的 LinearLayoutActivity。 

代码 2.11 LinearLayoutActivity 的 声明 


<?xml version="1.0" encoding="utf-8"?> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="mc.sample" 
android:versionCode="1" 


android:versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 


<application 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name"> 
<activity 
android:name=".HelloWorldActivity" 


</activity> 
<activity 
android:name=".LinearLayoutActivity" 
android:label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


完成 Activity 的 声明 之 后 ,在 应 用 程序 中 就 可 以 运行 定义 好 的 LinearLayoutActivity T , 
222 ”相对 布局 RelativeLayout 


RelativeLayout 允许 布局 中 的 控件 根据 其 他 控件 或 布局 本 身 的 相对 位 置 来 指定 如 何 
排列 。 因 此 ,可 以 使 用 以 右 对 齐 、 上 下 或 置 于 屏幕 中 央 等 形式 来 排列 两 个 元 素 。 布 局 中 的 
控件 是 按 顺 序 排列 的 ,如 果 第 一 个 元 素 在 屏幕 的 中 央 , 那 么 相对 于 这 个 元 素 的 其 他 元 素 将 
以 屏幕 中 央 的 相对 位 置 来 排列 。 如 果 使 用 XML 布局 文件 来 定义 这 种 布局 ,之 前 被 关联 


— 
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的 元 素 必须 定义 。 
RelativeLayout 布局 的 相关 属性 见 表 2. 1。 

































































表 2.1 RelativeLayout 布局 的 相关 属性 

属 性 含 义 
android:layout_above 将 该 控件 的 底部 置 于 给 定 ID 控件 之 上 
android:layout_below 将 该 控件 的 底部 置 于 给 定 ID 控件 之 下 
android:layout_toLeftOf 将 该 控件 的 右边 缘 与 给 定 ID 控件 左边 缘 对 齐 
android:layout_toRightOf 将 该 控件 的 左边 缘 与 给 定 ID 控件 右边 缘 对 齐 
android:layout_alignBaseline 将 该 控件 的 基准 线 与 给 定 ID 基准 线 对 齐 
android:layout_alignTop 将 该 控件 的 顶部 边缘 与 给 定 ID 顶部 边缘 对 齐 
android:layout_alignBottom 将 该 控件 的 底部 边缘 与 给 定 ID 底部 边缘 对 齐 
android:layout_alignLeft 将 该 控件 的 左边 缘 与 给 定 ID 左边 缘 对 齐 
android:layout_alignRight 将 该 控件 的 右边 缘 与 给 定 ID 右边 缘 对 齐 
android:layout_alignParentTop 如 果 为 true, 将 该 控件 的 顶部 与 其 父 控件 的 顶部 对 齐 
android:layout_alignParentBottom 如 果 为 true, 将 该 控件 的 底部 与 其 父 控件 的 底部 对 齐 
android:layout_alignParentLeft 如 果 为 true, 将 该 控件 的 左 部 与 其 父 控件 的 左 部 对 齐 
android:layout_alignParentRight 如 果 为 true, 将 该 控件 的 右 部 与 其 父 控件 的 右 部 对 齐 
android :layout_centerHorizontal 如 果 为 true, 将 该 控件 的 中 央 置 于 水 平 居中 
android:layout_centerVertical 如 果 为 true, 将 该 控件 的 中 央 置 于 垂直 居中 
android:layout_centerInParent 如 果 为 true, 将 该 控件 的 中 央 置 于 父 控件 的 中 央 
android:layout_marginTop 上 偏 移 的 值 
android:layout_marginBottom 下 偏 移 的 值 
android:layout_marginLeft 左 偏 移 的 值 
android:layout_marginRight 右 偏 移 的 值 








图 2. 11 是 采用 RelativeLayout 布局 显示 的 效果 。 
要 实现 这 个 界面 ,需要 下 面 几 个 步 又: 


(1) 创建 显示 界面 的 RelativeLayoutActivity 类 , 见 


代码 2. 12。 


(2) 创建 布局 文件 relative_layout. xml, 存放 在 
/res/layout 目录 下 , 见 代 码 2. 13。 


2.11 相对 布局 实例 效果 


(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 RelativeLayoutActivity 的 声明 。 


sea aann se 


代码 2. 12 RelativeLayoutActivity. java 





代码 1.13 relative layout. xml 
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android:text="OK" /> 


<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignTop="@id/ok" 
android:layout toLeftOf="@id/ok" 


android:text="Cancel" /> 


</RelativeLayout> 


223 表格 布局 TableLayout 


TableLayout 把 用 户 界 面 按 表格 形式 划 为 行 和 列 , 然 后 把 控件 分 配 到 指定 的 行 或 列 
中 。 一 个 TableLayout 由 许多 TableRow 组 成 ,每 个 TableRow 定义 一 行 row, 
TableLayout 容器 不 会 显示 行列 或 单元 格 cell 的 边框 线 。 每 行 可 有 0 个 或 多 个 cell; 每 
个 cell 能 容纳 一 个 View 对 象 。 表 格 允 许 cell 为 空 ,但 cell 不 能 跨 列 。 


android:collapseColumns 


以 第 0 行为 序 ,隐藏 指定 的 列 : 设置 android:collapseColumns 二 0,2 意思 是 把 第 0 列 
和 第 2 列 隐 藏 。 


android:shrinkColumns 


以 第 0 行为 序 , 自 动 延伸 指定 的 列 填充 可 用 部 分 : 当 LayoutRow 里 面 的 控件 还 没有 
布 满 布局 时 ,shrinkColumns 不 起 作用 ,设置 shrinkColumns 二 0,1,2, 布 局 完全 没有 改变 ， 
因为 LayoutRow 里 面 还 剩 足够 的 空间 。 当 LayoutRow 布 满 控件 时 ,设置 shrinkColumns 
三 2, 则 控件 自动 向 垂直 方向 填充 空间 。 


android:stretchColumns 


以 第 0 行为 序 , 尽 量 把 指定 的 列 填充 空白 部 
分 : 设置 stretchColumns 王 1, 则 结果 见 图 2. 12 ,第 
1 列 被 尽量 填充 (Button02 与 TextView02 同时 向 
右 填充 ,直到 TextView03 被 压 挤 到 最 后 边 ) 。 

要 实现 图 2. 12 所 示 的 界面 ,需要 下 面 几 个 
步骤 : 

(1) 创建 显示 界面 的 TableLayoutActivity 类 ; 图 2.12 表格 布局 实例 效果 

(2) 创建 布局 文件 table_layout. xml, 存放 在 
/res/layout 目录 下 , 见 代 码 2.14; 

(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 TableLayoutActivity 的 声明 。 
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代码 2.14 table layout. xml 
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2.3 使 用 布局 


Android 的 用 户 界面 布局 是 在 XML 文件 中 静态 记载 ,在 Android 的 Java 程序 中 动 
态 加 载 的 。 当 编译 Android 应 用 程序 时 ,每 一 个 XML 布局 文件 被 编译 成 View 视图 资 
源 ,应 用 程序 代码 在 Activity. onCreate ( ) 回调 中 实现 布局 资源 的 加 载 ,通过 调用 
setContentView() 传 递 给 它 的 形式 引用 到 布局 资源 R. layout. layout_file_name。 
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例如 ,如 果 XML 布局 文件 保存 于 main_layout. xml 中 ,实现 Activity 加 载 的 代码 如 
代码 2. 15。 
代码 2.15 Activity 加 载 布 局 文件 资源 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout .main layout); 

} 


1. 重用 布局 

Android 用 户 界面 的 布局 是 可 以 重用 的 。 重 用 布局 的 功能 非常 强大 ,因为 它 允 许 创 
建 可 重复 使 用 的 复杂 的 布局 。 在 应 用 程序 中 ,用 户 界面 布局 中 相同 或 类 似 的 任何 元 素 都 
可 以 被 提取 出 来 ,定义 成 一 个 独立 的 布局 文件 ,单独 管理 ,然后 在 需要 的 时 候 能 人 到 另 一 
个 布局 中 。 例 如 ,一 个 “是 / 否 ” 的 按钮 面板 ,或 自 定义 的 进度 条 说 明文 字 等 ,单独 定义 后 可 
以 嵌入 到 任何 其 他 布局 中 。 因 此 ,程序 员 可 以 根据 需求 灵活 地 设计 自 定 义 的 视图 ,定义 自 
己 特 殊 的 布局 。 

如 果 要 有 效 地 重复 使 用 完整 的 布局 ,可 以 在 当前 布局 使 用 的 ' 志 include/ 之 ' 和 
过 merge/ 盖 ' 的 标签 嵌入 到 另 一 个 布局 。 

下 面 通过 一 个 例子 来 具体 说 明 如 何 使 用 '<include/ >' 重 用 布局 。 

首先 创建 一 个 布局 文件 titlebar. xml, 其 中 定义 了 标题 栏 和 logo, 将 其 作为 重用 的 布 
局 , 见 代码 2. 16。 

代码 2.16 titlebar. xml 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@ color/titlebar bg"> 


<ImageView android:layout width="wrap content" 
android:layout height="wrap_content" 
android:src="@drawable/gafricalogo" /> 
</FrameLayout> 


创建 另 一 个 布局 文件 reuse_titlebar. xml, 使 用 ' 一 include/ 二 ' 的 标签 把 titlebar. xml 
定义 的 布局 嵌入 到 这 个 布局 中 , 见 代码 2. 17 中 带 下 画 线 的 语句 。 
代码 2. 17 reuse_titlebar. xml 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@ color/app bg" 
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android:gravity="center horizontal"> 
<include layout="@layout/titlebar"/> 


<TextView android:layout width="match parent" 
android:layout height="wrap content" 
android:text="@string/hello" 
android:padding="10dp" /> 


</LinearLayout> 


<merge> $R EE MAE UI 结构 时 起 到 很 重要 的 作用 。 目 的 是 通过 删 减 多 余 或 者 额 
外 的 层级 ,从 而 优化 整个 Android Layout 的 结构 。 

二 merge 二 的 另外 一 个 用 法 ,就 是 使 用 merge 二 蔡 代 Layout 标签 作为 重用 布局 文 
件 的 根 节点 时 , 当 另 一 个 布局 文件 使 用 Include 或 者 ViewStub 标签 从 外 部 导入 其 XML 
结构 时 ,可 以 很 好 地 将 它 所 包含 的 子 集 融 合 到 父 级 结构 中 ,而 不 会 出 现 宛 余 的 布局 节点 。 

例如 ,如 果 在 代码 2. 16 中 定义 的 Layout 是 LinearLayout, 则 布局 的 规则 与 重用 它 的 
代码 2. 17 相同 ,使 用 include 散人 布局 中 的 组 件 ,与 父 节 点 的 其 他 组 件 都 按照 同样 的 排列 
规则 显示 。 但 是 ,从 整个 Android Layout 的 结构 来 看 ,就 多 了 一 个 LinearLayout 宛 余 节 
点 。 在 代码 2.18 中 使 用 王 merge 之 替代 根 节点 ,嵌入 其 他 布局 文件 后 就 可 以 直接 采用 父 
节点 的 布局 ,与 父 节点 的 其 他 组 件 在 同一 级 结构 中 。 

代码 2. 18 merge_layout. xml 


<merge xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@ color/titlebar bg"> 


<ImageView android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@drawable/gafricalogo" /> 


</merge> 


2. 获取 控件 

在 布局 文件 中 定义 了 界面 的 布局 之 后 ,如 果 要 在 应 用 程序 中 对 控件 进行 操作 , 则 必须 
根据 布局 文件 中 的 定义 获取 控件 对 应 的 对 象 。 例 如 单 击 图 形 界面 的 一 个 按钮 后 ,需要 对 
这 个 按钮 的 事件 进行 处 理 ,执行 单 击 按钮 后 的 相应 代码 。 但 这 个 代码 写 在 哪里 呢 ? 应 用 
程序 中 没有 这 个 按钮 的 定义 ,也 没有 创建 这 个 按钮 对 象 。 因 此 ,应 用 程序 必须 根据 布局 文 
件 中 定义 的 其 ID 属性 ,从 Android 系统 中 获取 这 个 按钮 对 象 ,编写 其 对 应 的 事件 处 理 代 
码 , 界 面 才能 够 做 出 正确 的 响应 。 

每 个 View 和 ViewGroup 对 象 都 有 很 多 各 自 的 属性 ,有 些 属性 属于 特定 的 View 对 
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象 ,有 些 属性 是 所 有 View 对 象 共同 有 的 。 所 有 对 象 共同 有 的 属性 都 是 从 根 View 类 继承 
来 的 ,ID 属性 也 是 这 样 。 

在 XML 布局 文件 的 树 形 结构 中 , View 对 象 的 ID 属性 是 这 个 控件 的 唯一 标识 。 在 
XML 布局 文件 中 ,这 个 ID 通常 表现 为 一 个 字符 串 , 当 编译 应 用 程序 时 ,这 个 ID 会 被 引 
用 为 一 个 整数 。 这 是 一 个 公共 属性 ,我 们 会 经 常用 他 。 

下 面 是 在 XML 布局 文件 中 ,定义 一 个 控件 ID 属性 的 语法 : 


android:id="@ +id/my button" 


XML 解析 器 解析 @ 后 面 的 字符 串 ,my_button 就 是 指定 的 ID 字符 串 ,id 是 指 其 在 
R. java 文件 中 的 分 类 ;十 表示 这 是 一 个 新 的 资源 名 称 , 必 须 建立 并 加 入 到 项 目的 R. java 
文件 中 。 

获取 控件 包括 两 个 步骤 : 

(1) 在 布局 文件 中 定义 View 或 部 件 ,并 赋予 唯一 的 ID, 


<Button android:id="@+id/my _ button" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 


android:text="@string/my_button_text"/> 


(2) 在 Android 应 用 程序 中 ,使 用 findViewById() 引 用 布局 文件 中 的 部 件 ,创建 一 个 
部 件 对象 。 


Button myButton= (Button)findViewById(R.id.my _ button) 


2.4 样式 和 主题 


样式 是 用 于 指定 View 或 Windows 的 外 观 和 格式 的 一 系列 属性 的 集合 。 样 式 可 以 
指定 控件 或 布局 的 高 度 ,填充 . 字 体 颜 色 .字体 大 小 背景 颜色 等 等 属性 。Android 中 的 样 
式 与 网 页 设计 中 的 层 倒 样式 表 (CSS) 有 着 相似 的 原理 ,就 是 允许 我 们 将 设计 从 内 容 中 分 
离 出 来 。 例 如 ,使 用 一 个 样式 ,我 们 可 以 将 下 面 这 个 布局 : 


<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:textColor="#00FF00" 
android:typeface="monospace" 
android:text="@string/hello" /> 


变 成 这 样 ; 
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<TextView 
style="@style/CodeFont" 
android:text="@string/hello" /> 


这 样 ,将 所 有 与 样式 相关 的 属性 从 XML 布局 中 移出 , 放 到 一 个 名 为 CodeFont 的 样 
式 定义 中 ,通过 样式 属性 应 用 。 

主题 是 一 个 应 用 于 整个 Activity 或 应 用 中 ,而 不 是 某 一 个 单独 的 View。 当 一 个 样式 
被 作为 主题 来 应 用 时 , 则 这 个 样式 对 Activity 或 应 用 中 的 每 个 View 都 有 效 。 例 如 ,我 们 
能 把 CodeFont 样式 作为 主题 应 用 于 一 个 Activity, 那 么 这 个 Activity 中 所 有 文本 都 将 是 
绿色 等 宽 字体 。 


2.4.1 定义 样式 


如 果 要 创建 一 套 样式 ,需要 在 项 目的 res/values/ 目录 下 创建 一 个 XML 文件 ,来 定 
义 样 式 。 定 义 样式 的 XML 文件 名 称 由 程序 员 任 意 指定 ,但 必须 使 用 . xml 作为 扩展 名 ， 
保存 在 res/values/ 文件 夹 中 ,而且 文件 中 的 根 节 点 必须 是 一 resources 二 。 

resources 节点 下 由 style 子 元 素 定义 样式 的 具体 配置 ,其 name 属性 所 创建 样式 的 唯 
一 标识 。style 元 素 下 可 以 有 多 个 <<item 之 子 元 素 ,具体 来 定义 View 各 属性 的 配置 。 
<item>Jú# t & — name 属性 和 一 个 对 应 值 ,说 明 这 一 项 设 定 哪个 View 的 属性 的 样 
式 。<<item> 元 素 本 身 的 值 可 以 是 一 个 关键 字符 串 、 十 六 进 制 颜色 、 另 一 个 资源 类 型 的 
引用 或 其 他 值 , 它 是 属性 的 样式 值 。 代 码 2. 19 是 CodeFont 的 样式 定义 ,可 以 看 出 样式 
定义 XML 文件 的 结构 和 语法 。 

代码 2. 19 style_sample. xml 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<style name="CodeFont" parent="@android:style/TextAppearance .Medium"> 
<item name="android:layout_width">fill_parent</item> 
<item name="android:layout_height">wrap_content</item> 
<item name="android:textColor">#00FF00</item> 
<item name="android:typeface">monospace< /item> 
</style> 


</resources> 


BS <resources> 元 素 的 子 节点 在 编译 时 都 被 转换 为 一 个 应 用 程序 资源 对 象 , 可 通 
<style> 元 素 的 name 属性 的 值 来 引用 。 例 如 前 面 代码 中 的 样式 ,通过 style = 
"@style/CodeFont" 语 句 来 引用 。 

在 二 style> 元 素 中 的 parent 属性 是 可 选 的 ,让 我 们 能 够 从 指定 的 style 中 继承 所 有 
属性 。 通 过 这 种 途径 从 一 个 现 有 的 style 中 继承 属性 后 ,可 以 根据 需求 改变 或 添加 的 属 
性 ,从 而 创建 新 的 样式 。 例 如 ,下 面 的 样式 定义 是 从 Android 平台 默认 文本 外 观 样 式 继 
承 ,修改 了 一 下 文本 的 颜色 。 
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<style name="GreenText" parent="@android:style/TextAppearance"> 
<item name="android:textColor">#00FF00</item> 


</style> 


如 果 要 继承 的 是 自 定义 的 样式 ,就 不 必 使 用 parent 属性 ,而 使 用 “. ”把 原 有 的 样式 和 
新 样式 名 连接 起 来 。 例 如 ,下 面 的 代码 创建 了 一 个 新 样式 , 它 继承 前 面 定义 的 CodeFont， 
但 把 颜色 改 为 红色 。 


<style name="CodeFont .Red"> 
<item name="android:textColor">#FF0000</item> 


</style> 


这 里 没有 使 用 parent 属性 ,name 属性 以 CodeFont 起 始 ,使 用 “. ”连接 了 后 面 的 新 样 
式 名 称 。 这 个 新 样式 可 以 通过 @style/CodeFont. Red 来 引用 。 样 式 的 继承 可 以 有 和 多重。 
例如 下 面 的 代码 ,从 CodeFont 和 CodeFont. Red style 中 同时 继承 ,然后 添加 android: 
textSize 属性 。 


<style name="CodeFont .Red.Big"> 
<item name="android:textSize">30sp</item> 
</style> 


这 种 技巧 仅 适用 于 将 自 定义 的 资源 链接 起 来 ,不 能 用 这 种 方式 继承 Android 内 置 的 
style。 要 引用 一 个 Android 的 内 置 style, 必 须 使 用 parent 属性 。 


242 使 用 样式 


定义 一 个 样式 之 后 ,如 果 对 一 个 View 应 用 了 这 个 样式 ,而 这 个 View 并 不 支持 此 样 
式 中 设 定 的 某 些 属性 ,那么 此 View 将 应 用 那些 它 支持 的 属性 ,并 简单 忽略 那些 不 支 
持 的 。 

在 Activity 或 应 用 程序 中 有 两 种 方式 来 使 用 style: 

A) 对 一 个 独立 的 View, 在 布局 文件 XML 中 将 style 属性 添加 到 的 此 View 元 
素 中 ; 

(2) 对 一 个 Activity 或 应 用 ,在 AndroidManifest. xml 文件 中 将 android: theme 属性 
添加 到 的 一 activity> w <application> 元 素 中 。 

如 果 将 一 个 style 应 用 到 布局 中 一 个 单独 的 View 上 时 ,此 style 定义 的 属性 会 仅 应 
用 于 那个 View。 如 果 一 个 style 应 用 到 一 个 ViewGroup 上 ,其 子 View 元 素 并 不 会 继承 
应 用 此 style 属性 ,只 有 直接 设置 其 子 元 素 此 style, 才 会 起 作用 。 但 是 ,通过 第 二 种 方式 ， 
将 style 作为 theme 来 应 用 的 方式 ,将 会 把 这 个 style 应 用 到 此 Activity 1< application> 
的 所 有 View 元 素 上 。 

下 面 是 在 XML 布局 中 为 View 设置 style 的 简单 语法 : 


sel 
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<TextView 
style="@style/CodeFont" 
android:text="@string/hello" /> 


如 果 需 要 对 应 用 程序 中 所 有 Activity 设置 一 个 theme, 则 打开 AndroidManifest. xml 
文件 并 编辑 二 application 标签 ,使 之 包含 android: theme 属性 和 style 名 称 , 具 体 设置 
代码 如 下 : 


<application android:theme="@ style/CustomTheme"> 


如 果 希 望 theme 仅 应 用 到 应 用 程序 中 的 某 个 Activity 中 ,那么 就 将 android: theme 
属性 添加 到 一 activity> 标签 中 。 


2.5 理解 资源 


Android 应 用 程序 不 仅 包括 逻辑 代码 ,还 包括 资源 文件 ,如 人 字符、 图片 .布局 和 语言 
持 等 。Android 系统 对 于 资源 的 管理 使 用 了 一 种 将 资源 外 部 化 的 模式 。 这 种 方式 ,使 得 
应 用 程序 可 以 在 代码 编译 时 ,只 是 使 用 资源 的 引用 ,在 代码 编译 后 修改 资源 包含 的 内 容 也 
不 会 影响 程序 的 逻辑 。 从 而 保持 程序 逻辑 和 资源 的 各 自 独立 。 对 于 外 部 资源 ,可 以 通过 
提供 替代 资源 的 方式 ,支持 不 同 的 语言 或 屏幕 大 小 。 随 着 越 来 越 多 不 同 配置 的 Android 
设备 的 出 现 , 这 种 模式 对 于 Android 程序 运行 于 复杂 多 变 的 环境 尤其 重要 。 

Android 的 资源 以 文件 形式 ,在 项 目的 res/ 目 录 下 进行 统一 管理 。 为 了 提供 具有 不 
同 配置 的 兼容 性 ,必须 在 项 目的 res/ 目录 中 组 织 资源 ,在 其 不 同 子 目录 中 存放 不 同 的 资源 
类 型 和 配置 。 对 于 任何 类 型 的 资源 ,都 可 以 指定 默认 情况 下 使 用 的 资源 和 多 个 替代 资源 。 

使 用 默认 资源 的 条 件 是 指 可 以 支持 任何 配置 的 Android 设备 或 当前 的 配置 没有 替代 
资源 匹配 ,图 2. 13 中 的 界面 只 设计 有 一 种 布局 ;而 蔡 代 的 资源 是 为 特定 配置 设计 的 ， 
图 2.14 中 的 界面 为 横向 的 屏幕 设置 了 替代 布局 。 通 过 资源 文件 目录 名 ,Android 系统 会 
自动 应 用 相应 的 资源 文件 ,匹配 设备 当前 的 配置 。 
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图 2.13 布局 设计 之 一 


对 于 res/ 目 录 下 的 资源 ,应 用 程序 可 以 通过 引用 资源 ID 号 来 调用 。 具 体 的 资源 ID 
号 能 够 从 R. java 中 查 到 。 对 于 每 一 种 资源 类 型 都 有 一 个 R 的 子 类 对 应 着 (例如 R. 
drawable 中 包含 着 所 有 drawable 资源 ) ,并 且 对 每 个 特定 类 型 的 所 有 资源 都 有 一 个 静态 
的 整 型 数值 一 一 对 应 (例如 R. drawable. icon) 。 这 个 整 型 数值 就 是 这 个 特定 资源 的 ID 
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图 2.14 布局 设计 之 二 


号 ,通过 它 能 获取 对 应 的 资源 。 
一 个 资源 的 ID 号 一 般 的 组 成 如 下 : 
。 资源 类 型 。 每 种 资源 都 会 被 分 组 到 一 种 特定 的 资源 类 型 ,例如 string, drawable 
A layout 等 ,还 有 更 多 的 资源 类 型 ,如 raw,color 等 。 
。 资源 名 。 资 源 名 同时 也 是 文件 名 ,不 包括 拓展 名 ;或 者 是 XML 中 android: name 
属性 的 值 ,这 种 情况 适用 于 这 个 资源 是 一 个 简单 的 值 ( 例 如 一 个 字符 串 ) 。 


2.5.1 提供 资源 


res/ 的 子 目录 中 包含 了 所 有 资源 ,资源 目录 名 是 很 重要 的 , 表 2. 2 列 出 了 资源 目录 和 
具体 资源 类 型 的 对 照 。 


表 2.2 资源 目录 和 资源 类 型 
































目录 资源 类 型 
animator/ 存放 定义 属性 动画 的 XML 文件 
anim/ 存放 定义 补 建 动画 的 XML 文件 
color/ 存放 定义 颜色 值 的 XML 文件 
PE sn png.. jpg. gif.. 9. png) ,或 者 是 被 编译 成 可 描画 资源 类 型 的 XML 
layout/ 存放 定义 用 户 界面 布局 的 XML 文件 
menu/ 存放 定义 应 用 程序 菜单 的 XML 文件 ,如 选项 菜单 、 上 下 文 菜单 或 子 菜单 
raw/ 存放 任意 原生 格式 的 文件 
values/ 存放 包含 简单 值 的 XML 文件 ,如 字符 串 ,整数 以 及 颜色 等 
iy 放 在 这 个 目录 下 的 任意 XML 文件 ,都 可 在 运行 时 通过 调用 Resources. getXMLO 
方法 来 读 取 





值得 注意 的 是 ,不 能 把 资源 文件 直接 保存 在 res/ 目录 中 ,这 样 会 导致 编译 错误 。 

保存 在 表 2. 2 中 所 定义 子 目录 中 的 资源 是 默认 资源 。 也 就 是 说 ,这 些 资 源 定 义 了 
Android 应 用 程序 用 户 界面 的 默认 设计 和 内 容 。 

但 是 ,对 于 同一 个 应 用 程序 来 说 ,可 以 根据 Android 设备 的 不 同 特性 和 设置 预先 定义 
不 同类 型 的 资源 ,以 方便 应 用 程序 的 用 户 界面 切合 运行 时 的 硬件 设备 。 例 如 ,可 以 针对 竖 
屏 和 横 屏 设 定 不 同 的 布局 资源 文件 ,以 满足 屏幕 切换 的 需要 。 或 者 也 可 以 针对 不 同 的 语 
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言 ,提供 不 同 的 字符 串 资源 ,使 得 在 用 户 界面 上 显示 与 设备 语言 相 匹配 的 文字 。 要 给 不 同 
的 设备 配置 提供 这 些 不 同 的 资源 ,除了 默认 的 资源 以 外 ,还 要 提供 可 选 的 替代 资源 。 


252 ”访问 资源 


Android 应 用 程序 引用 某 个 资源 时 ,有 两 种 方法 。 

(1) 在 Java 应 用 程序 代码 中 直接 调用 ,通过 调用 Resources 类 中 的 方法 来 获取 某 一 
特定 的 资源 ,通过 getResources() 方 法 得 到 Resources 类 的 一 个 实例 。 在 应 用 程序 代码 
中 引用 资源 的 语法 如 下 : 


[<package name>.]R.<resource_type> .<resource_name> 


Jt rh ,<package_name> 4K t WR B fE HA o hn 3 E R FEN A 2 p BU) € A BJ , X 
字段 不 需要 填写 。 所 resource _type>> 指 R 类 下 对 应 一 种 特定 资源 类 型 的 子 类 , 如 
R. String。 二 resource_name 可 以 是 不 包含 文件 扩展 名 的 资源 文件 名 或 者 XML 元 素 中 
android:name 属性 的 值 。 

例如 ,Java 应 用 程序 中 的 语句 "R. drawable. my_background_image" 调 用 了 资源 类 型 
为 drawable, 资 源 名 为 my_background_image 的 Android 资源 。 实 际 上 就 是 引用 了 
Android 定义 好 的 图 片 资 源 。 


// 使 用 drawable 类 型 的 图 片 资源 给 当前 屏幕 加 载 背景 
getWindow() .setBackgroundDrawableResource 

(R.drawable .my background image); 

// 使 用 Layout 类 型 的 布局 资源 作为 当前 屏幕 的 布局 


setContentView(R.layout .main screen); 


(2) 在 XML 中 调用 ,通过 特殊 的 XML 语法 引用 R. class 文件 中 的 相关 资源 ID。 在 
XML 资源 文件 中 引用 资源 的 语法 如 下 : 


@[<package name>:]<resource type>/<resource name> 


语句 中 各 标记 的 含义 同上 。 
例如 ,XML 布局 文件 中 的 语句 "@color/opaque_red" 和 "@string/hello" 调 用 了 资源 
类 型 分 别 为 Color 和 String, 资 源 名 分 别 为 opaque_red 和 hello 的 Android 资源 。 


// 使 用 color 资源 类 型 的 opaque_red 的 颜色 资源 作为 文本 颜色 
android:textColor="@ color/opaque red" 
// 使 用 string 资源 类 型 的 hello 的 字符 串 作为 文本 显示 的 内 容 


android:text="@string/hello" /> 


上 面 语句 中 的 资源 定义 都 在 本 项 目 中 ,这 种 情况 不 需要 说 明 包 。 如 果 要 引用 
Android 系统 定义 的 资源 , 则 需要 包含 包 名 。 例 如 : 
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<?xml version="1.0" encoding="utf-8"?> 

<EditText xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill parent" 
android:layout_height="fill_parent" 
android:textColor="@android:color/secondary text dark" 
android:text="@ string/hello"/> 


应 该 在 任何 时 候 都 使 用 字符 串 资源 ,以 便 应 用 程序 能 够 针对 其 他 语言 进行 本 地 化 。 

我 们 可 以 在 任何 需要 使 用 自己 提供 的 资源 的 地 方 , 通 过 这 两 种 语法 来 调用 。 

在 Android 系统 中 ,不 仅仅 资源 本 身 可 以 被 引用 ,在 定义 样式 时 ,也 可 以 引用 样式 属 
性 。 引 用 样式 属性 的 语法 与 普通 的 资源 格式 几乎 是 等 同 的 ,但 是 使 用 问号 “?” 取 代 符号 
“@”, 资 源 类 型 部 分 是 可 选 的 ,语法 格式 如 下 : 


?[<package name>:][<resource type>/]<resource name> 


下 面 的 例子 是 引用 Android 设 定 的 一 个 样式 属性 textColorSecondary 来 设置 布局 中 
TextView 的 文本 颜色 ,使 得 其 匹配 系统 主题 的 “ 主 ” 文 本 的 颜色 。 这 里 不 需要 说 明 样 式 
属性 的 资源 类 型 。 


<EditText id="text" 

android:layout width="fill parent" 

android:layout height="wrap content" 
android:textColor="?android:textColorSecondary" 
android:text="@string/hello_world" /> 


Android 中 包含 有 很 多 标准 的 资源 ,例如 styles( 样 式 ) .themes( 主 题 ) ,layouts( 布 
局 ) 等 。 要 调用 这 些 资源 ,需要 通过 Android 包 名 来 限定 这 些 资源 。 


2.6 多 屏幕 适应 


移动 终端 的 类 型 繁多 ,屏幕 的 尺寸 .长 宽大 小 比例 也 多 种 多 样 。Android 应 用 程序 要 
运行 在 不 确定 的 屏幕 上 ,Android 系统 需要 处 理 适 配 不 同 显示 屏幕 的 工作 。 因 此 Android 
系统 对 不 同 的 屏幕 尺寸 和 密度 提供 API, 应 用 程序 能 够 设计 提供 不 同 的 屏幕 尺寸 和 密度 
的 用 户 界 面 。 应 用 程序 运行 时 ,系统 通过 适当 的 管理 方式 ,针对 当前 的 屏幕 配置 引用 与 对 
应 的 资源 进行 适 配 ,调整 布局 和 位 图 。 

如 果 没 有 替代 的 布局 资源 ,系统 则 采用 屏幕 默认 设计 ,并 根据 屏幕 的 大 小 进行 缩放 和 
调整 。 但 通过 提供 多 种 屏幕 布局 的 方式 ,可 以 最 大 程度 优化 用 户 体验 。 

Android 系统 是 怎样 支持 多 种 屏幕 的 呢 ? 在 应 用 程序 用 户 界面 设计 中 ,可 以 从 以 下 
几 个 方面 来 设 定 对 多 种 屏幕 的 支持 。 

1. 明确 声明 应 用 程序 支持 的 所 有 屏幕 尺寸 

在 AndroidManifest. xml 文件 中 ,使 用 二 supports-screens 二 元 素 说 明 应 用 程序 能 够 


基于 Android 平台 的 移动 互联 网 应 用 开发 (第 版 ) 





支持 的 屏幕 尺寸 。 通 过 声明 应 用 程序 支持 的 屏幕 尺寸 ,可 以 保证 只 有 那些 屏幕 尺寸 被 应 
用 程序 支持 的 设备 才 可 以 下 载 该 应 用 程序 。 

2. 为 不 同 的 屏幕 尺寸 提供 不 同 的 布局 

默认 情况 下 ,Android 可 以 重新 调整 应 用 程序 的 布局 ,以 适应 当前 的 设备 屏幕 。 但 有 
时 候 可 能 调整 后 的 屏幕 布局 不 太美 观 , 这 就 需要 应 用 程序 针对 特殊 的 屏幕 (过 大 或 过 小 ) 
设计 不 同 的 布局 。 在 大 多 数 情 况 下 ,这 是 可 行 的 。 使 用 配置 限定 符 能 够 提供 与 尺寸 相关 
的 资源 ,这些 限 定 符 包 括 small, normal, large 和 xlarge。 如 果 应 用 程序 运行 在 Android 
3. 2(API Level 13) 以 上 , 则 需要 使 用 sw<N> dp 配置 限定 符 定义 布局 资源 所 需 的 最 小 
可 用 宽度 。 例 如 600dp 屏幕 以 上 的 布局 ,放置 在 layout-sw600dp/ 目 录 下 。 下 面 代码 就 是 
一 个 设 定 布局 的 简单 例子 : 


res/layout/my_layout.xml //layout for normal screen size ("default") 
res/layout-small/my_layout.xml //layout for small screen size 
res/layout-large/my_layout.xml //layout for large screen size 
res/layout-xlarge/my_layout.xml //layout for extra large screen size 


res/layout-xlarge-land/my_layout.xml 


//layout for extra large in landscape orientation 


3. 为 不 同 的 屏幕 尺寸 提供 不 同 的 位 图 

默认 情况 下 , Android 系统 会 在 应 用 程序 运行 时 ,根据 运行 设备 的 屏幕 缩放 位 图 
(. png.. jpg 和 . gif 文件 ) 和 Nine-Patch(. 9. png 文件 ) ,使 它们 显示 出 合适 的 物理 尺寸 。 
但 这 种 缩放 有 时 会 失真 。 最 好 的 方法 是 为 不 同 的 屏幕 密度 提供 不 同 分 辨 率 的 位 图 。 

Android 系统 使 用 限定 符 ldpi(low)、mdpi(medium)、hdpi(high) 和 xhdpi (extra 
high) ,来 提供 密度 相关 的 资源 。 见 如 下 代码 ,为 高 密度 屏幕 提供 的 位 图 放 在 drawable- 
hdpi/ 目 录 下 。 


res/drawable-mdpi/my icon.png //bitmap for medium density 
res/drawable-hdpi/my icon.png //bitmap for high density 
res/drawable-xhdpi/my icon.png //bitmap for extra high density 


当 Android 应 用 程序 运行 时 ,系统 怎样 使 用 适当 的 可 选 资源 呢 ? 系统 会 根据 当前 屏 
幕 的 大 小 和 密度 配置 ,查找 应 用 程序 提供 的 布局 和 密度 相关 资源 ,确定 最 佳 匹配 的 资源 目 
录 下 的 资源 。 例 如 ,应 用 程序 在 一 个 高 密度 的 大 屏幕 上 显示 一 个 drawable 资源 ,系统 会 
寻找 最 接近 此 大 屏幕 的 布局 ,高 密度 drawable 目录 的 资源 来 使 用 。 

如 果 没 有 匹配 的 资源 是 可 用 的 ,系统 将 使 用 默认 的 资源 并 且 对 其 进行 缩放 来 适应 当 
前 的 屏幕 尺寸 和 和 密度。 默认 的 资源 是 那些 没有 配置 限定 符 的 资源 。 


2.7 本 章 小 结 


本 章 主 要 介绍 了 Activity 的 概念 和 生命 周期 ,以 及 如 何 使 用 Activity 类 创建 用 户 界 
面 。Activity 是 Android 的 四 大 基本 组 件 之 一 ,通过 Activity, 用 户 可 以 与 移动 终端 进行 
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XH.. Activity 的 生命 周期 中 有 Active/Running、Paused、Stopped 和 Killed 四 种 状态 。 

本 章 还 着 重 介绍 了 布局 概念 和 分 类 。Activity 中 的 具体 图 形 控件 由 Android 定义 的 
View 类 和 ViewGroup 类 的 子 类 对 象 组 成 ,这 些 对 象 在 Activity 中 的 排列 结构 , 称 为 用 户 
界面 的 布局 。Android 有 五 种 基本 的 布局 对 象 : FrameLayout( 框 架 布 局 )、LinearLayout 
(线性 布局 ) .AbsoluteLayout( 绝 对 布局 )、RelativeLayout( 相 对 布局 ) 和 TableLayout( 表 
格 布局 ) Android 的 用 户 界面 布局 是 在 XML 文件 中 静态 记载 ,在 Android 的 Java 程序 
中 动态 加 载 的 。 在 这 一 章 中 ,针对 每 一 种 基础 布局 ,使 用 具体 的 代码 实现 说 明了 如 何在 用 
户 界面 中 使 用 这 些 布局 。 

在 本 章 的 偏 后 部 分 介绍 了 如 何 使 用 Android 项 目 中 的 样式 和 资源 的 概念 。 


Fragment 和 图 形 控件 


3.1 理解 Fragment 


Android 运行 在 各 种 各 样 的 设备 中 ,有 各 种 尺寸 的 手机 、 各 种 标准 的 平板 电脑 、 各 种 
类 型 的 控制 屏幕 甚至 电视 ,而 且 在 使 用 移动 设备 时 ,用 户 还 会 经 常 转换 屏幕 的 纵横 角度 。 
虽然 可 以 通过 提供 不 同 尺 寸 的 位 图 、 声 明 多 种 屏幕 尺寸 来 解决 分 辨 率 不 同 的 问题 ,但 如 果 
要 App 的 界面 友好 美观 ,还 需要 做 大 量 工作 来 为 同一 界面 设计 多 个 布局 ,实现 多 屏幕 
适应 。 

在 开发 过 程 中 ,一般 都 是 先 基于 手机 开发 一 套 App, 然 后 复制 一 份 ,修改 布局 以 适应 
超级 大 屏幕 。 难 道 无 法 做 到 一 种 UI 的 布局 可 以 同时 适应 手机 和 平板 吗 ? 在 手机 的 UI 
布局 设计 过 程 中 , 主要 是 定义 其 中 View 和 ViewGroup 对 象 的 层级 结构 。 如 果 把 这 些 结 
构 模 块 化 ,就 可 以 直接 在 屏幕 转换 角度 或 在 平板 电脑 等 大 屏幕 的 布局 上 使 用 了 。 
Fragment 出 现 的 初衷 就 是 为 了 解决 这 样 的 问题 。 


3.1.1 Fragment 的 概念 


Fragment 是 Activity 中 用 户 界面 的 一 部 分 ,Fragment 是 一 种 灵活 的 、 可 重用 UI 组 
件 。 可 以 把 一 个 Fragment 看 成 是 Activity 的 一 个 布局 模块 ,概念 上 可 以 理解 成 Java 语 
言 中 Frame 中 的 Panel, 可 以 容纳 具有 某 种 层次 结构 的 View 和 ViewGroup 对 象 。 

Android 系统 从 Android 3.0(API level 11) 开 始 推出 Fragment, 主要 目的 是 支持 多 
屏幕 更 加 动态 和 灵活 的 UI 设计 。 用 户 界 面 设 计时 ,把 一 个 Activity 切 分 成 多 个 
Fragment, 那 么 在 把 App 从 手机 屏幕 迁移 到 大 屏幕 时 ,布局 设计 就 不 再 需要 改变 和 管理 
Fragment 内 部 的 View 层次 结构 ,而 可 以 重点 考虑 Activity 的 显示 外 观 了 。 

例如 ,一 个 应 用 在 手机 中 使 用 Activity A 显示 文章 列表 ,Activity B 显示 列表 中 对 应 
的 文章 内 容 。 当 用 户 单 击 Activity A 中 文章 列表 的 一 项 时 , Activity A 启动 Activity B, 
在 Activity B 中 显示 选中 的 文章 内 容 , 见 图 3. 1 右 图 。 如 果 每 一 个 Activity 都 使 用 一 个 
Fragment 来 容纳 界面 上 的 View 对 象 ,在 设计 这 个 应 用 在 平板 电脑 的 布局 时 ,就 可 以 不 
必 考 虑 具体 每 一 个 图 形 控件 的 排列 位 置 和 关系 ,只 需要 考虑 屏幕 的 容纳 空间 ,适合 排列 哪 
些 Fragment ,考虑 用 户 操作 时 的 友好 性 。 这 里 在 一 个 Activity 中 同时 并 排 显示 两 个 
Fragment, 见 图 3. 1 左 图 。 如 果 用 户 单 击 左边 Fragment 文章 列表 中 的 一 项 ,选中 的 文章 
内 容 直 接 显 示 在 右边 的 Fragment B 中 ,不 需要 在 启动 另 一 个 Activity, 也 使 App 的 显示 
界面 更 友好 美观 。 
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图 3.1 Fragment 的 使 用 实例 


Fragment 必须 放置 在 Activity 中 使 用 ,不 能 独立 存在 。Fragment 具有 自己 的 生命 
周期 ,但 它 的 生命 周期 也 直接 受 所 在 的 Activity 生命 周期 的 影响 ,例如 当 一 个 Activity 被 
销毁 时 ,所 包含 的 所 有 Fragment 也 都 被 销毁 了 。 一 个 Activity 中 可 以 包含 多 个 
Fragment, 每 个 Fragment 都 定义 自己 的 布局 ,并 在 生命 周期 中 的 回调 方法 中 定义 自己 的 
动作 。Fragment 之 间 是 相互 独立 的 ,Activity 通过 回 退 栈 来 管理 每 个 Fragment 发 生 的 
事件 ,每 一 个 对 Fragment 操作 的 事件 ,都 会 添加 到 会 退 栈 中 。 通 过 回 退 栈 ,允许 用 户 通 
过 回 退 键 取消 已 经 执行 的 动作 。 

Activity 的 生命 周期 ,直接 影响 Fragment 的 生命 周期 。 在 Activity 状态 转换 时 , 生 
命 周期 中 每 一 个 回调 方法 的 调用 ,都 导致 其 中 的 Fragment 对 应 的 回调 方法 的 调用 。 与 
Activity 类 似 ,Fragment 以 三 个 状态 存在 : Resumed, Paused 和 Stopped。 在 状态 之 间 转 
换 时 ,系统 会 调用 相应 的 回调 方法 。 下 面 以 一 个 应 用 实例 ,来 详 述 Fragment 的 创建 和 使 
用 ( 见 图 3.2). 

Fragment 状态 之 间 转 换 时 ,会 有 多 个 事件 发 生 , 每 一 个 事件 都 会 有 Fragment 回调 方 
法 调用 。 这 些 事件 对 应 的 回调 方法 如 下 : 

。 onAttach() 在 Fragment 对 象 添 加 到 Activity 中 时 调用 。 

* onCreate() 在 创建 Fragment 对 象 时 调用 。 

。 onCreateView() 在 Fragment 绘制 用 户 界面 时 调用 。 

。 onActivityCreated() 所 在 Activity 和 Fragment 的 UI 界面 创建 时 调用 。 

。 onStart() 在 任何 UI 变化 时 ,Fragment 开始 变 为 可 视 状 态 时 调用 。 

。 onResume() 在 Fragment 开始 变 为 运行 状态 时 调用 。 

。 onPause() 在 Fragment 运行 状态 结束 ,线程 挂 起 ,所 在 Activity 不 再 是 前 台 界面 
时 调用 。 
onSaveInstanceState() 在 Fragment 运行 状态 结束 ,保存 UI 状态 时 调用 时 。 
onStop() 在 可 见 状态 结束 时 调用 。 
onDestroyView() 在 Fragment 视图 被 删除 时 调用 。 
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图 3.2 Activity Fragment 的 生命 周期 


。 onDestroy() 在 Fragment 生命 周期 结束 时 调用 。 


。 onDetach() 当 Fragment 被 所 在 Activity 删除 时 调用 。 
Activity 中 的 每 一 个 Fragment 都 是 Fragment 类 的 子 类 。 在 定义 Fragment 时 ,除了 
可 以 直接 使 用 Fragment 类 ,还 有 一 些 子 类 可 以 使 用 。 例 如 ,DialogFragment, 直接 定 义 浮 
动 显 示 的 对 话 框 ;ListFragment, 已 经 定义 好 了 一 个 列表 的 显示 ;PreferenceFragment, 可 
以 把 偏好 对 象 的 系列 显示 成 一 个 列表 。 
在 进行 UI 布局 设计 时 ,考虑 把 每 一 个 Fragment 都 设计 成 Activity 的 可 重用 组 件 。 
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这 样 ,一 个 设计 好 的 Fragment 不 仅 可 以 在 多 种 屏幕 设计 时 使 用 ,也 可 以 由 同一 设备 的 多 
+ Activity 使 用 。 在 构建 Activity 时 , 既 可 以 静态 使 用 多 个 Fragment, 也 可 以 在 Activity 
运行 时 根据 用 户 的 交互 情况 ,对 Fragment 进行 添加 、 移 除 、 蔡 换 以 及 执行 其 他 动作 。 

下 面 详 述 Fragment 的 创建 和 使 用 。 


3.1.2 创建 和 使 用 Fragment 


在 Activity 中 使 用 Fragment, 可 以 通过 XML 布局 文件 先 定义 Fragment 的 UI 布 
局 ,然后 直接 在 Activity 的 XML 布局 文件 中 引用 定义 好 的 Fragment。 通 过 这 种 方式 在 
Activity 使 用 Fragment 的 方法 , 称 为 在 Activity 中 静态 添加 Fragment, 

在 Activity 中 静态 添加 Fragment 需要 完成 下 面 几 项 工作 : 

(1) 创建 Activity 子 类 和 Fragment FÆ. 

(2) 定义 Fragment 布局 。 

(3) 添加 Fragment 布局 到 Activity 布局 中 。 

(4) Fragment 中 事件 处 理 。 

(5) 在 Manifest 文件 中 注册 Activity。 

下 面 为 了 讨论 静态 添加 Fragment 的 过 程 ,在 Android Studio 建立 一 个 新 的 App 项 
目 , 命 名 为 C03Fragment, 主 Activity 命名 为 MainActivity, Company Domain 定义 为 
uibe. edu. cn ,实现 如 图 3. 3 所 示 的 运行 显示 效果 。 在 这 个 例子 用 户 界面 的 Activity 中 ， 
设置 了 两 个 Fragment, 其 中 一 个 Fragment 显示 图 片 列表 , 男 一 个 显示 大 图 片 和 图 片 描 
述 , 并 实现 了 单 击 列表 中 图 标 在 另 一 个 Fragment 中 显示 图 片 和 描述 的 事件 处 理 。 
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图 3.3 Fragment 实例 效果 


下 面 通过 这 个 例子 , 详 述 静态 添加 Fragment 具体 的 步骤 和 代码 。 
1. 创 建 Activity 和 Fragment FÆ 
在 这 个 例子 中 ,在 MainActivity 中 显示 两 个 Fragment 的 UI 定义 内 容 。 首 先 打开 


s 
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MainActivity, 将 其 继承 的 父 类 改 为 FragmentActivity, 见 代 码 3. 1。 在 修改 完成 后 , 按 
Alt 十 Enter 键 ,导入 所 需 的 java 包 。 
代码 3.1 修改 MainActivity 类 


public class MainActivity extends FragmentActivity { 


J 


然后 ,创建 Fragment FÆ. fE Android Studio 的 Project 视图 中 , 右 击 app, 选择 
New—-Fragment—Fragment(Blank) ,在 Configure Component 对 话 框 中 ,设置 Fragment 
Name 为 PictureFragment, 选 定 默认 的 Fragment Layout Name, 取 消 选 中 其 下 面 的 两 个 
复 选 框 , 单 击 Finish 按钮 。 用 同样 的 步骤 创建 另 一 个 TinyFragment 类 , 见 图 3.4。 

Fragment 与 Activity 有 类 似 的 周期 ,在 创建 Fragment 时 ,如 果 没 有 取消 选中 图 3. 4 
中 的 复 选 框 ,Fragment 的 类 中 会 列 出 所 有 生命 周期 的 回调 函数 。 

在 这 个 例子 中 ,PictureFragment 只 需要 在 onCreateVeiw() 中 ,使 用 下 面 的 代码 获取 
XML 布局 文件 定义 的 Fragment 布局 就 可 以 了 。 后 面 可 以 根据 需要 ,在 必要 的 生命 周期 
的 回调 函数 中 添加 动作 。 


inflater.inflate(R.layout.fragment picture, container, false); 


® New Android Component x 


yx Configure Component 


Crestes a blank fragment that is compatible back to API level 人 
Fragment Nomes [mm | 
Creste layout XML? 
Frogment Layout Name: [toomertsmy O O O O 
C include fragment factory methods? 


O include interface callbacks? 


Target Source Set: main B 


Generate event callbacks for communication with an Activity or other fragments 








ee 
图 3.4 创建 Fragment 


2. 定义 Fragment 布局 

Fragment 的 XML 布局 定义 与 Activity 类 似 , 都 是 在 某 个 布局 内 放置 布局 和 组 件 来 
定义 UI 的 显示 层次 和 结构 。 这 里 ,首先 把 要 显示 的 图 片 复 制 到 res/drawable 目录 下 , 形 
成 图 片 资源 文件 ,然后 打开 res/layout 目录 下 PictureFragment 的 布局 文件 fragment_ 
pciture. xml, 添 加 UI 界面 需要 的 ImageView 和 TextView, 各 属性 及 其 他 具体 设置 等 完 
整 的 代码 见 代码 3.2。 其 中 android: weight 表示 组 件 在 布局 中 显示 时 所 占 的 比重 ,也 就 
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是 比例 大 小 。 
代码 3.2 fragment_picture. xml 





同样 打开 res/layout 目录 下 TinyFragment 的 布局 文件 fragment_tiny. xml, 使 用 水 
平 深 动 视图 HorizontalScrollView, 添 加 图 标的 滚动 功能 ,并 使 用 一 个 ImageView 定义 需 
要 显示 的 一 个 小 图 标 ,各 属性 及 其 他 具体 设置 等 完整 的 代码 见 代 码 3. 3。 如 果 要 在 
Fragment 中 添加 更 多 的 ImageView, 可 以 按 代码 3. 3 中 的 ImageView 控件 的 设置 ,在 添 
加 的 LinearLayout 中 ,注意 设置 每 个 ImageView 不 同 的 ID 值 。 

在 本 章 的 例子 中 , 共 添 加 了 六 个 ImageView, 以 方便 看 到 滑动 的 效果 。 

代码 3.3 fragment tiny. xml 
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3. 添加 到 Activity 中 

每 一 个 Fragment 都 必须 放置 在 一 个 FragmentActivity 中 , FragmentActivity 是 
Android 的 Support Library 中 专门 用 于 Fragment 处 理 的 Activity 子 类 ,从 API level 11 
开始 支持 。 如 果 是 低 于 API level 11 版 本 的 Android 系统 ,就 直接 使 用 Activity, 

在 FragmentActivity 的 XML 布局 文件 中 直接 定义 所 使 用 的 Fragment, 以 及 它们 在 
Activity 中 的 层次 和 结构 ,完成 Fragment 与 这 个 FragmentActivity 的 关联 过 程 ,就 是 静 
态 添加 Fragment 的 过 程 。 

在 这 个 例子 中 ,MainActivity 的 XML 布局 文件 activity_mian. xml 中 定义 了 界面 所 
需要 使 用 的 两 个 Fragment: PictureFragment 和 TinyFragment, 以 及 它们 的 层次 结构 和 
属性 ,完整 代码 见 代 码 3.4。 

代码 3.4 activity_main. xml 
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tools:layout="@layout/fragment_picture" /> 


<fragment 
android:id="@+id/fragment2" 
android:name="cn.edu.uibe.c03fragment .TinyFragment" 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight="1" 
tools:layout="@layout/fragment tiny" /> 


</LinearLayout> 


然后 可 以 在 MainActivity 的 onCreate() 方 法 中 使 用 “setContentView (R. layout. 
activity_main) ;” 调 用 定义 的 布局 文件 ,生成 用 户 界面 。 这 时 ,还 没有 实现 单 击 小 图 标 在 
大 图 中 显示 的 功能 。 要 实现 这 一 步 ,还 需要 对 TinyFragment 中 的 ImageView 进行 单 击 
事件 处 理 。 

4. Fragment 中 组 件 的 事件 处 理 

相对 于 Actiivty 来 说 , Fragment 中 组 件 的 事件 处 理 比 较 复 杂 。 因 为 在 目前 的 
Android 版 本 中 ,不 支持 Fragment 中 使 用 android:onClick 属性 设置 单 击 事件 回调 方法 ， 
也 就 是 说 ,不 能 在 Fragment 的 布局 文件 中 设置 ImageView 的 单 击 响 应 方法 ,只 能 通过 基 
于 监听 接口 的 事件 处 理 机 制 来 进行 处 理 ,通过 Java 源 程序 实现 onClickedListener 来 进行 
事件 处 理 。 

在 通过 View 的 onClickedListener 处 理 Fragment 时 ,只 有 静态 添加 的 Fragment 中 
的 控件 , 才 可 以 使 用 Activity 的 findViewById() 方 法 ,通过 R. id 来 获取 Fragment 中 的 
控件 对 象 。 如 果 是 动态 添加 的 Fragment, 无 法 使 用 这 种 方式 来 获取 对 象 ,只 能 采用 其 他 
的 方式 。 

代码 3. 5 中 的 showImage() 方 法 中 ,实现 了 TinyFragment 中 的 ImageView 单 击 事 
件 处 理 。showImage() 方 法 使 用 Activity 的 findViewById() 方 法 获取 了 TinyFragment 
中 的 ImageView 对 象 ,并 把 onClickedListener 注册 到 这 个 控件 ,在 其 onClick() 方 法 中 实 
现 单 击 事件 响应 ,把 单 击 的 图 片 显示 到 PictureFragment 的 大 图 中 。 

到 此 为 止 ,就 完成 了 本 节 开 始 所 显示 例子 的 功能 。 

代码 3.5 TinyFragment 中 的 ImageView 单 击 事件 处 理 


package cn.edu.uibe.c03fragment; 


import android.os.Bundle; 
import android.support.v4.app.FragmentActivity; 
import android.view.View; 


import android.widget.ImageView; 


public class MainActivity extends FragmentActivity { 


Ne Z 
— 





— 
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private ImageView showImg; 

private ImageView tinyImg; 

int imgId[]={R.id.tinyImagel,R.id.tinyImage2,R.id.tinyImage3,R.id. 
tinyImage4,R.id.tinyImage5,R.id.tinyImage6); 


@override 

protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView (R.layout.activity main); 
showImg= (ImageView) findViewById (R.id.imageView show); 


showImage () ; 


protected void showImage () [ 
for (int i=0;i<imgId.length;i++) { 
tinyImg= (ImageView)findViewById(imgId[i]); 
tinyImg.setOnClickListener (new View.OnClickListener() { 
public void onClick(View v) { 
ImageView img= (ImageView) v; 


showImg.setImageDrawable (img.getDrawable ()); 


3.1.3 创建 动态 UI 


Android 系统 支持 Fragment 的 主要 目的 是 为 了 让 App 适应 不 同 的 屏幕 尺寸 和 位 
置 ,方便 App 的 UI 设 计 和 代码 在 不 同类 型 的 屏幕 上 执行 时 重用 。 因 此 根据 屏幕 不 同 的 
尺寸 和 位 置 , 动 态 改变 用 户 界 面 显示 的 内 容 , 让 用 户 界面 美观 友好 、 适 用 ,是 Fragment 
更 重要 的 作用 。 

所 谓 动态 UI, 是 在 Activity 运行 时 App 能 够 根据 屏幕 的 状态 自动 添加 、 删 除 、 蔡 换 
组 成 用 户 界 面 的 Fragment 或 Fragment 中 的 组 件 ,能 够 自动 重新 组 织 Fragment 的 布局 ， 
给 用 户 提供 一 个 自 适应 的 操作 显示 界面 。 

这 种 在 Activity 的 生命 周期 中 ,对 Fragment 进行 动态 添加 、 删 除 .替换 或 其 他 动作 的 
行为 , 称 为 Fragment 事务 。Android 系统 使 用 FragmentManager 创建 FragmentTrasaction 
来 完成 Fragment 事务 处 理 。 

在 进行 Fragment 事务 处 理 时 ,初始 添加 Fragment 的 事务 必须 在 Activity 的 
onCreate( ) 方 法 中 完成 ,而 且 这 个 Activity 在 需要 添加 Fragment 的 位 置 必须 包含 一 个 容 
器 类 的 View, 例 如 LinearLayout。 这 个 容器 类 的 View 可 以 在 布局 文件 中 静态 定义 ,也 
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可 以 在 Activity 的 onCreate() 中 由 Java 源 程序 预先 创建 ,添加 到 Activity 中 。 

如 果 创 建 动态 UI, 需 要 完成 下 面 的 工作 : 

(1) 创建 Activity 和 Fragment FÆ. 

(2) 定义 需 静 态 或 动态 添加 的 Fragment 布局 。 

(3) 根据 添加 Fragment 和 Fragment 事务 的 策略 ,定义 Activity 布局 。 

(4) 动态 添加 、 删 除 或 替换 Fragment, 

(5) 动态 Fragment 的 事件 处 理 。 

(6) 在 Manifest 文件 中 声明 Activity, 

为 了 详细 讨论 如 何在 Activity 上 实现 Fragment 事务 ,如 何 处 理 动态 Fragment 中 组 
件 的 时 间 处 理 , 下 面 我 们 在 上 3. 1. 2 W C03Fragment 项 目 例子 的 基础 上 ,修改 程序 ,实现 
在 竖 屏 时 动态 添加 TinyFragment, 在 横 屏 时 动态 删除 TinyFragment, 以 及 在 
TinyFragment 中 的 ImageView 单 击 事件 处 理 , 并 在 实现 这 个 例子 的 过 程 中 ,详细 描述 具 
体 的 步骤 和 代码 。 

1. 定义 Activity 布局 

因为 是 在 C03Fragment 项 目的 基础 上 对 程序 进行 修改 ,所 以 创建 动态 UI 的 (1)、(2) 
步 都 已 经 完成 。 下 一 步 需 要 修改 MainActivity 的 布局 文件 activity _ main. xml, 删除 
TinyFragment 的 定义 部 分 ,取消 MainActivity 在 初始 化 时 静态 添加 TinyFragment ,在 需 
要 动态 添加 TinyFragment 的 位 置 定 义 一 个 容器 LinearLayout, 容纳 在 MainActivity 运 
行 时 动态 添加 的 TinyFragment, 完 成 第 (3) 步 。 

添加 的 容器 LinearLayout 的 具体 设置 和 代码 见 代码 3.6. 

代码 3.6 动态 添加 Fragment 的 Activity 布局 定义 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 


android:orientation="vertical"> 


<fragment 
android:id="@+id/fragment picture" 
> 


<LinearLayout 
android:id="@+id/content tiny" 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight="1" 


android:background="@android:color/background dark" 
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android:orientation="horizontal"> 
</LinearLayout> 


</LinearLayout> 


2. 动态 添加 和 删除 Fragment 

Activity 实现 动态 添加 、 删 除 和 替换 等 Fragment 事务 ,是 通过 类 FragmentManager 
和 类 FragmentTrasaction 来 实现 的 , 见 代 码 3.7。 

代码 3.7 Fragment 事务 处 理 


FragmentManager manager=getSupportFragmentManager () ; //(1) 
FragmentTransaction transaction=beginTransaction(); // (2) 
transaction.add(R.id.fragment container, firstFragment); ZZQ) 
transaction.remove (R.id.fragment_container, secondFragment); AAEN 
transaction .replace (R.id.fragment_container, thirdFragment); // (3) 
transaction.commit (); // (4) 


一 般 来 说 ,实现 Fragment 事务 需要 下 面 几 步 : 

(1) 调用 Activity 的 getSupportFragmentManager() 方 法 ,获取 当前 Activity 的 
FragmentManager 对 象 ,赋值 给 FragmentManager 变量 manager, 

(2) 通过 对 象 manager 调用 beginTransaction() ,创建 启动 Fragment 事务 对 象 ,并 赋 
值 给 一 个 FragmentTransaction 变量 transaction 。 

(3) 通过 对 象 transaction 调用 add() ,remove() ,replace() 执 行 Fragment 事务 ,动态 
添加 、 删 除 、 蔡 换 Fragment。 在 执行 Fragment 事务 时 ,可 以 根据 需要 ,执行 一 个 或 多 个 
事务 。 

(4) 使 用 对 象 transaction 调用 commit() 方 法 提交 所 有 的 Fragment 事物 。 

在 本 例 中 ,修改 MainActiivity 的 onCreate() 方 法 ,在 其 中 添加 Fragment 事务 的 语 
句 。 通 过 计 语 句 判断 当前 屏幕 的 状态 ,在 竖 屏 时 ,实现 TinyFragment 的 动态 添加 ,在 横 
屏 时 实现 TinyFragment 删除 , 见 代 码 3.8。 

代码 3.8 添加 和 删除 TinyFragment 


protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedIinstanceState); 
setContentView(R.layout .activity main); 


showImg= (ImageView)findViewById(R.id.imageView show); 
txt= (TextView)findViewById(R.id.imageTxt); 


if (this.getResources().getConfiguration().orientation== 
Configuration.ORIENTATION PORTRRIT) { 
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tiny=new TinyFragment (); 
tiny.setArguments (get Intent () .getExtras ()); 


FragmentManager manager=getSupportFragmentManager (); 
FragmentTransaction transaction=manager.beginTransaction(); 


transaction.add(R.id.content_tiny, tiny, "tinyfragment"); 


transaction.commit (); 

}else{ 
FragmentManager manager=getSupportFragmentManager (); 
tiny=manager.findFragmentByTag("tinyfragment"); 
FragmentTransaction transaction=manager.beginTransaction(); 
if(tiny!=null) transaction.remove (tiny); 


transaction.commit (); 


} 


这 时 ,运行 App, 会 发 现 App 出 现 运 行 异常 。 这 是 因为 静态 Fragment 中 的 控件 ,可 
以 直接 通过 Activity 的 findViewById() 方 法 获取 ,设置 onClickedListener, 但 在 动态 
Fragment 中 ,无 法 通过 同样 的 方式 获取 控件 ,得 到 的 只 是 空 指针 。 对 空 指针 进行 操作 ， 
App 就 出 现 了 异常 。 所 以 对 于 动态 Fragment 中 的 控件 事件 处 理 , 需 要 另 一 套 机 制 。 

在 MainActivity 中 ,删除 原 有 的 事件 处 理 代 码 , 即 删 除 showImage() 方 法 实现 ,并 删 
除 的 onCreate() 中 的 showImage() 调 用 语句 。 重 新 运行 App, 就 可 以 看 到 预期 的 显示 效 
ET: 竖 屏 时 显示 TinyFragment 中 的 小 图 标 列 表 ; 横 屏 时 ,只 能 看 到 PictureFragment 
中 的 大 图 和 注释 信息 , 见 图 3. 5 所 示 的 动态 Fragment 显示 效果 。 





图 3.5 动态 Fragment 显示 效果 


3. 动态 Fragment 的 事件 处 理 

在 动态 用 户 图 形 界 面 上 ,经 常会 通过 一 个 Fragment 中 控件 的 操作 ,来 影响 另 一 个 
Fragment 的 显示 结果 。 例 如 , 单 击 邮 件 列表 中 的 标题 ,会 改变 邮件 内 容 的 显示 。 要 实现 
这 个 功能 ,程序 员 需 要 解决 两 个 问题 : 

。 在 Fragment 之 间 传 递 消息 。 

° 确定 事件 源 , 设 定 事件 处 理 器 。 
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在 Android 系统 中 ,所 有 的 Fragment 之 间 进 行 通信 ,必须 通过 其 所 在 的 Activity 进 
行 , 两 个 Fragment 之 间 无 法 进行 直接 的 消息 传递 。 

要 实现 一 个 Fragment 与 其 所 在 的 Activity 之 间 的 通信 ,可 以 在 这 个 Fragment 中 定 
义 一 个 Interface 接口 ,然后 再 Activity 中 实现 其 包含 的 方法 。 当 Fragment 运行 设置 事 
件 源 的 回调 方法 onAttach() 中 时 ,会 捕获 这 个 接口 ,实现 与 Activity 的 通信 。 

因为 在 Activity 中 无 法 获取 动态 Fragment 中 的 控件 ,Fragment 也 无 法 在 XML 布 
局 文件 中 设置 事件 响应 回调 方法 ,所 以 必须 使 用 基于 监听 器 的 事件 处 理 机 制 ,在 
Fragment 生命 周期 回调 方法 onAttach() 中 ,通过 Fragment 的 findViewById() 获 取 需 要 
进行 事件 处 理 的 控件 ,在 控件 上 设置 监听 器 ,在 事件 处 理 方法 中 编写 事件 处 理 代码 。 当 然 
在 onCreate () 中 实现 也 可 以 。 

本 例 中 要 实现 单 击 TinyFragment 中 的 小 图 标 ,在 PictureFragment 中 显示 对 应 的 大 
图 ,必须 把 TinyFragment 中 单 击 的 信息 传递 给 PcitureFragment, 然后 才能 使 
PictureFragment 中 的 ImageView 显示 出 对 应 的 大 图 。 下 面 通过 例子 ,说 明 如 何 使 用 接 
口 来 传递 消息 ,进行 事件 处 理 。 

1) 定义 Interface 

首先 ,在 TinyFragment 中 定义 接口 ImageClickedListener, 并 声明 此 接口 的 变量 
mCallback 作为 TinyFragment 和 Activity 传递 消息 的 工具 , 见 代码 3. 9。 

代码 3.9 定义 ImageClickedListener 接口 


public class TinyFragment extends Fragment { 
ImageClickedListener mCallback; 


public interface ImageClickedListener{ 
public void updateImage (ImageView img); 
} 


然后 在 TinyFragment 的 onAttach() 方 法 中 ,通过 getView(). findViewById() 获 取 
ImageView 对 象 ,在 其 上 设置 setOnClickListener, 并 在 其 事件 处 理 方法 onClick() 中 使 用 
mCallback 调用 MainActivity 定义 的 updateImage( ) 方 法 ,通过 参数 把 消息 传递 给 
MainActiivty ,并 通过 MainActivity 对 PictureFragment 进行 操作 , 见 代 码 3. 10。 

代码 3. 10 定义 ImageClickedListener 


public class TinyFragment extends Fragment { 
ImageView tinyImage; 
int imgId[]={R.id.tinyImagel,R.id.tinyImage2, R.id.tinyImage3,R.id. 
tinyImage4,R.id.tinyImage5,R.id.tinyImage6}; 


int tinysize=6; 


public void onAttach (Activity activity) { 
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2) 实现 Interface 

TinyFragment 与 MainActivity 之 间 消 息 能 传递 成 功 的 关键 ,在 于 TinyFragment 中 
把 mCallback 获取 的 MainActivity 作为 接口 使 用 ,调用 了 接口 ImageClickedListener 在 
MainActivity 中 实现 后 的 updateImage() 方 法 。 具 体 的 实现 代码 见 代码 3.11. 

代码 3.11 在 MainActivity 中 实现 ImageClickedListener 





到 此 为 止 ,就 完成 了 创建 动态 UI 的 例子 ,可 以 运行 App 查看 运行 效果 。 


3.2 常用 基本 控件 


Android 系统 为 用 户 界面 的 设计 提供 了 很 多 图 形 控件 ,在 这 一 节 中 我 们 介绍 一 些 常 
用 的 基本 控件 ,及 其 事件 处 理 方法 。 
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3.2.1 事件 处 理 机 制 


由 于 Android 应 用 程序 使 用 Java 程序 编写 ,在 应 用 程序 运行 中 ,用 户 对 移动 终端 键 
盘 、 屏 幕 和 位 置 的 操作 都 转化 成 事件 对 象 , Android 系统 通过 对 这 些 事件 的 捕获 后 ,执行 
相应 的 处 理 代码 ,实现 与 用 户 的 交互 ,完成 预定 的 功能 。 这 个 过 程 就 是 Android 的 事件 
处 理 。 

Android 的 事件 处 理 机 制 有 两 种 : 基于 监听 接口 和 基于 回调 。 这 两 种 机 制 的 原理 和 
实现 方法 都 有 所 不 同 。 

1. 基于 监听 接口 的 事件 处 理 机 制 

事件 机 制 是 处 理事 件 的 方式 和 方法 。Android 的 基于 监听 接口 的 事件 处 理 机 制 , 完 
全 采用 了 Java 的 事件 处 理 机 制 。 

Java 的 事件 处 理 基于 委托 事件 处 理 模 型 ,把 事件 的 发 生 与 事件 的 处 理 相 分 离 , 由 监 
听 器 监听 (等 待 ) 事 件 发 生 , 事 件 发 生 后 再 由 监听 器 委托 事件 处 理 器 处 理 。Java 采取 了 授 
权 事 件 模型 (Delegation Event Model) ,事件 源 可 以 把 在 其 自身 所 有 可 能 发 生 的 事件 分 别 
授权 给 不 同 的 事件 处 理 者 来 处 理 。 

在 事件 处 理 的 过 程 中 ,主要 涉及 三 个 主要 部 分 : 事件 源 、 事 件 和 事件 处 理 。 

1) 事件 源 (Event Source) 

事件 源 ,是 指 触摸 屏 、 键 盘 或 位 置 传感器 操作 针对 的 控件 或 容器 。 事 件 发 生 时 ,也 就 
是 出 现 某 个 控件 被 触摸 操作 或 移动 终端 位 置 移动 ,这 个 控件 ,也 就 是 事件 源 类 负责 发 送 事 
件 发 生 的 通知 ,并 通过 事件 源 查找 自己 的 事件 监听 者 队列 ,并 将 事件 信息 通知 队列 中 的 监 
听 者 来 完成 。 同 时 ,事件 源 还 在 得 到 有 关 监 听 者 信息 时 负责 维护 自己 的 监听 者 队列 。 

2) 事件 (Event) 

事件 ,是 指 对 组 件 或 容器 的 触摸 屏 、 键 盘 或 位 置 的 一 个 操作 ,用 类 描述 。 例 如 键盘 事 
件 类 KeyEvent 描述 键盘 事件 的 所 有 信息 : 键 按 下 ,释放 双击、 组 合 键 以 及 键 码 等 相关 键 
的 信息 。 

3) 事件 处 理 (Event Handler) 

Java 的 事件 处 理由 事件 监听 器 类 和 事件 监听 器 接口 来 实现 。 事 件 发 生 后 ,事件 源 将 
相关 的 信息 通知 对 应 的 监听 器 ,事件 源 和 监听 者 之 间 通 过 监听 者 接口 完成 这 类 的 信息 交 
换 。 事 件 监 听 者 类 就 是 事件 监听 者 接口 的 具体 实现 ,事件 发 生 后 ,该 主体 负责 进行 相关 的 
事件 处 理 , 同 时 , 它 还 负责 通知 相关 的 事件 源 , 自己 关注 它 的 特定 的 事件 ,以 便 事件 源 在 事 
件 发 生 时 能 够 通知 该 主体 。 

外 部 的 操作 ,例如 按 下 按键 .触摸 屏幕 单 击 按钮 或 转动 移动 终端 等 动作 ,会 触发 事件 
源 上 的 事件 。 对 于 单 击 按钮 的 操作 来 说 ,事件 源 就 是 按钮 , 它 会 根据 这 个 操作 生成 一 个 按 
钮 按 下 的 事件 对 象 ,这 对 于 系统 来 说 ,就 产生 了 一 个 事件 。 

事件 的 产生 会 触发 事件 监听 器 ,事件 本 身 作为 参数 传人 到 事件 处 理 器 中 。 事 件 监听 
器 是 在 通过 代码 在 程序 初始 化 时 注册 到 事件 源 的 ,也 就 是 说 ,在 按钮 上 设置 一 个 可 以 监听 
按钮 操作 的 监听 器 ,并 且 通 过 这 个 监听 器 调用 事件 处 理 器 ,事件 处 理 器 针对 这 个 事件 编写 
代码 ,例如 弹出 一 条 信息 。 
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在 代码 实现 时 ,基于 监听 器 的 事件 处 理 都 需要 做 三 项 工作 : 

。 定义 监听 器 类 ,覆盖 对 应 的 抽象 方法 ,在 监听 器 中 针对 事件 编写 响应 的 处 理 代码 。 

。 创建 监听 器 对 象 。 

。 注册 监听 器 。 

2. 基于 回调 的 事件 处 理 机 制 

Android 的 另 一 种 事件 处 理 机 制 是 回调 机 制 。 

通常 情况 下 ,程序 员 写 程序 时 ,需要 使 用 系统 工具 类 提供 的 方法 来 完成 某 种 功能 , 例 
如 调用 Math. sqrt() 求 取 平方 根 。 但 是 , 某 种 情况 下 系统 会 反 过 来 调用 一 些 类 的 方法 , 例 
如 对 于 用 作 组 件 或 插件 的 类 则 需要 编写 一 些 供 系统 去 调用 的 方法 ,这 些 专门 用 于 被 系统 
调用 的 方法 被 称 为 回调 方法 ,也 就 是 回 过 来 系统 调用 的 方法 。 

Android 平 台中 ,每 个 View 都 有 自己 的 处 理事 件 的 回调 方法 ,开发 人 员 可 以 通过 重 
写 View 中 的 这 些 回调 方法 来 实现 需要 的 响应 事件 。 当 某 个 事件 没有 被 任何 一 个 View 
处 理 时 , 便 会 调用 Activity 中 相应 的 回调 方法 。 例 如 ,有 一 个 按钮 按 下 的 事件 发 生 了 ,但 
编码 过 程 中 这 个 按钮 并 没有 对 这 个 事件 做 任何 处 理 , 它 所 在 的 Activity 中 的 任何 组 件 也 并 
没有 对 这 个 事件 做 任何 处 理 ,这 时 系统 会 调用 Activity 相应 的 回调 方法 onKeyDown()。 

回调 机 制 实质 就 是 将 事件 的 处 理 绑 定 在 组 件 上 ,由 GUI 组 件 自己 处 理事 件 ,回调 机 
制 需要 自 定义 View 来 实现 , 自 定义 View 重 写 该 View 的 事件 处 理 方法 就 可 以 了 。 例 
如 ,Activity 和 Fragment 的 生命 周期 中 的 各 种 状态 发 生变 化 时 ,调用 的 onResume() 等 方 
法 ,也 是 回调 方法 。 

Android 也 提供 自 定 义 回 调 方法 ,例如 在 前 面 两 章 的 例子 中 ,通过 XML 文件 中 的 组 
f android:onClicked 属性 , 自 定 义 了 回调 方法 的 名 称 , 然 后 直接 在 Activity 中 覆盖 这 个 
方法 ,进行 单 击 事件 处 理 。 这 是 一 种 非常 有 效 的 简单 的 事件 处 理 实现 方式 。 

这 两 种 事件 处 理 机 制 都 是 在 Android 应 用 程序 开发 过 程 中 常用 的 机 制 ,程序 员 可 以 
根据 实际 情况 ,选择 合适 的 方式 。 前 面 的 章节 中 ,我 们 既 运用 了 基于 监听 接口 的 事件 处 理 
机 制 , 例 如 在 3. 1 节 中 ,也 运用 了 基于 回调 的 事件 处 理 机 制 , 例 如 在 第 1.2 章 的 例子 中 。 
在 以 后 的 章节 中 ,我 们 也 会 根据 实际 情况 ,选择 合适 的 事件 处 理 机 制 。 
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Android 提供 的 按钮 控件 有 很 多 种 ,包括 基本 的 Button、RadioButton、CheckBox、 
ToggleButton 和 Switch 都 是 按钮 的 类 型 。 

Button 类 控件 继承 自 TextView, 因 此 也 具有 TextView 的 宽 和 高 设置 .文字 显示 等 
一 些 基 本 属性 。Button 类 控件 在 应 用 程序 中 的 定义 ,与 其 他 图 形 控件 一 样 ,一 般 都 在 布 
局 文件 中 进行 定义 、 设 置 和 布局 设计 。setText() 和 getText() 是 Button 类 控件 最 常用 的 
方法 ,用 于 设置 和 获取 Button 显示 的 文本 。 

Button 类 控件 一 般 会 与 单 击 事件 联系 在 一 起 。 对 于 基本 的 Button, 可 以 采用 两 种 方 
式 处 理 单 击 事件 。 一 种 使 用 Button 的 setOnClickListener ( ) 方法 为 其 设置 
OnClickListener, 把 具体 的 事件 处 理 代码 写 在 onClick( View v) 方法 中 ; 另 一 种 在 XML 
布局 文件 中 ,使 用 Android:OnClick 属性 为 Button 指定 单 击 事件 发 生 时 执行 的 方法 。 
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如 果 在 XML 布局 文件 中 ,使 用 Android: OnClick 属性 指定 了 单 击 事件 的 回调 方法 ， 
这 个 方法 在 Java 应 用 程序 中 必须 是 public 的 ,而 且 只 有 一 个 View 类 型 的 参数 。 

在 按钮 类 控件 的 使 用 过 程 中 ,属性 设置 和 事件 处 理 稍 有 不 同 ,下 面具 体 说 明 各 按钮 类 
控件 如 何 对 事件 进行 处 理 。 在 具体 调试 运行 过 程 中 ,创建 资源 文件 和 Activity 的 具体 步 
又 与 前 面 例子 相同 ,请 参考 其 编写 完整 的 代码 ,运行 并 查看 效果 。 

1. Button 

Button 即 按钮 。 按 钮 控件 可 以 有 文本 或 者 图 Alam Q Q Alarm 
标 ,也 可 以 文本 和 图 标 同时 存在 ( 见 图 3. 6) , 当 用 户 
触摸 时 就 会 触发 事件 。 

根据 按钮 控件 的 组 成 方式 ,创建 按钮 控件 有 三 种 方式 : 

1) 如 果 由 文本 组 成 ,使 用 Button 类 创建 





图 3.6 各 种 按钮 


<Button 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/button_text" 
/> 


2) 如 果 由 图 标 组 成 ,使 用 ImageButton 类 创建 


<ImageButton 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@drawable/button icon" 
/> 


3) 如 果 文 本 和 图 标 都 有 ,使 用 Button 类 的 android:drawableLeft 属性 


<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@ string/button text" 
android:drawableLeft="@drawable/button icon" 
/> 


除了 按钮 上 的 文本 和 图 标 ,按钮 的 外 观 ( 如 背景 图 片 和 字体 ) 可 能 会 因为 设备 或 者 
Android 版 本 的 不 同 而 有 所 不 同 , 随 着 Android 版 本 的 升级 ,其 界面 的 样式 也 发 生变 化 ， 
而 厂家 的 也 会 定制 输入 控件 的 默认 样式 。 

如 果 要 控制 控件 ,使 用 适用 于 整个 应 用 程序 的 样式 。 例 如 ,要 确保 所 有 运行 Android 
4.0 甚至 更 高 版 本 的 设备 在 应 用 程序 使 用 Holo 主题 ,需要 在 manifest 的 元 素 中 声明 
android:theme 一 "@android:style/Theme. Holo" 。 

在 XML 布局 文件 中 ,可 以 使 用 Button 的 一 些 属性 来 定义 按钮 的 外 观 。 定 制 不 同 的 


BF Famen 和 图 形 控件 





背景 ,可 以 指定 一 android:background> 属 性 为 绘图 或 颜色 的 资源 ,也 可 以 是 自 定义 的 背 
景 。 其 他 的 属性 ,如 字体 、 大 小 、 边 框 等 ,可 以 参照 TextView 和 View 的 XML 属性 。 详 
细 的 XML 属性 说 明 可 以 从 链接 http://developer. android. com/reference/android/ R. 
styleable. html 查阅 。 

下 面 是 一 个 简单 的 例子 ,使 用 了 一 种 无 边框 按钮 。 无 边框 按钮 与 基本 按钮 相似 ,但 是 
无 边框 按钮 没有 边框 或 背景 ,但 在 不 同 状态 如 单 击 时 会 改变 外 观 。 要 创建 一 个 无 边框 按 
钮 ,为 按钮 应 用 二 borderlessButtonStyle 才 样式 , 见 代码 3. 12。 

代码 3. 12 按钮 外 观 设置 


<Button 
android:id="@+id/button send" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@ string/button send" 
android:onClick="sendMessage" 
style="?android:attr/borderlessButtonStyle" /> 


2. RadioButton 

RadioButton 就 是 单 选 按 钮 ,在 Android 开发 中 应 用 的 非常 广泛 。RadioButton 的 外 
形 是 单个 圆 形 的 单 选 框 ,具有 选中 或 未 选中 两 种 状态 。 在 RadioButton 没有 被 选中 时 ,用 
户 能 够 按 下 或 单 击 来 选中 它 。 与 复 选 框 不 同 的 是 ,用 户 一 旦 选中 就 不 能 够 取消 选中 。 

一 般 来 说 , 实现 RadioButton 需要 由 RadioButton 和 RadioGroup 配合 使 用 。 
RadioGroup 是 单 选 组 合 框 ,是 可 以 容纳 多 个 RadioButton 的 容器 。 在 没有 RadioGroup 
的 情况 下 ,RadioButton 可 以 全 部 都 选中 ; 当 多 个 RadioButton 被 RadioGroup 包含 的 情况 
下 ,RadioButton 只 可 以 选择 一 个 。 

RadioButton 的 事件 处 理 , 可 以 使 用 setOnCheckedChangeListener() 方 法 注册 单 选 
按钮 的 监听 器 ,也 可 以 采用 在 XML 布局 文件 中 指定 处 理 方法 的 方式 。 

下 面 这 个 例子 ,在 XML 布局 文件 中 定义 了 一 个 具有 四 个 RadioButton 的 
RadioGroup, 一 个 文本 显示 框 TextView 控件 和 一 个 按钮 Button 控件 , 见 代码 3.13。 当 
一 个 RadioButton 被 选中 时 ,在 TextView 控件 中 显示 选择 项 的 文本 ,如 果 单 击 按钮 ,将 
清除 选中 的 项 目 。 

代码 3.13 radiobutton_layout. xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<RadioGroup 
android:layout width="match parent" 


Z 
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在 这 个 例子 中 没有 指定 事件 处 理 的 方法 ,因此 ,在 Java 应 用 程序 中 ,采用 控件 相对 应 
的 两 个 事件 监听 器 RadioGroup. OnCheckedChangeListener 和 View. OnClickListener 来 处 理 
对 RadioGroup 和 RadioButton 的 事件 ,具体 的 事件 处 理 代 码 写 在 onCheckedChanged() 和 
onClick() 接 口 方 法 中 ,分 别 实现 根据 选项 更 新 TextView 的 显示 和 清除 RadioButton 选 
中 的 功能 , 见 代码 3. 14。 

代码 3.14 RadioGroupActivity. java 
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public void onCheckedChanged (RadioGroup group, int checkedId) { 
String selection=getString(R.string.radio group selection); 
String none=getString (R.string.radio group none); 
mChoice.setText (selection 
+ (checkedId==View.NO ID ? none : checkedId)); 
} 


public void onClick(View v) { 
mRadioGroup.clearCheck () ; 


} 


完成 应 用 程序 编码 后 ,同样 不 要 忘记 要 到 AndroidManifest. xml 中 注册 才能 运行 。 

从 上 面 的 例子 可 以 看 出 ,Android 控件 的 事件 处 理 方法 与 一 般 的 Java 图 形 界面 处 理 
类 似 , 只 是 控件 和 监听 器 有 所 不 同 ,所 采用 的 事件 处 理 机 制 和 原理 以 及 实现 步骤 都 基本 
相同 。 

3. CheckBox 

CheckBox 就 是 复 选 框 , 具 有 选中 和 未 选中 两 种 状态 。CheckBox 的 外 形 是 矩形 框 ， 
可 以 通过 单 击 选中 或 取消 选中 。 在 进行 事件 处 理 时 ,应 用 程序 可 以 根据 是 否 被 选中 来 进 
行 相应 的 操作 ,并 且 对 复 选 框 加 载 事 件 监听 器 ,来 对 控件 状态 的 改变 做 出 响应 。 

下 面 这 个 例子 ,通过 XML 布局 文件 在 用 户 界面 使 用 CheckBox 控件 来 创建 一 个 复 选 
框 ,实现 当 复 选 框 被 单 击 时 ,弹出 一 个 文本 消息 显示 复 选 框 的 当前 状态 。 

(1) 创建 XML 布局 文件 checkbox_layout. xml, 定 义 一 个 CheckBox 控件 ,并 在 其 中 
使 用 android:onClick 属性 指定 事件 处 理 的 方法 名 为 onCheckBoxClicked, 见 代码 3.15. 

代码 3.15 checkbox_layout. xml 





<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 


android:orientation="vertical"> 


<CheckBox 
android:id="@+id/checkbox" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:onClick="onCheckBoxClicked" 


android:text="check it out" /> 


</LinearLayout> 
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(2) 创建 新 类 CheckBoxActivity ,实现 XML 文件 中 指定 的 单 击 CheckBox 控件 后 的 
事件 处 理 方法 onCheckBoxClicked( View v) , 见 代 码 3. 16。 
代码 3. 16 CheckBoxActivity. java 





public class CheckBoxActivity extends Activity { 


@override 

protected void onCreate (Bundle savedInstanceState) ( 
//TODO Auto-generated method stub 
super.onCreate (savedInstanceState); 


setContentView (R.layout.checkbox_ layout); 


public void onCheckboxClicked(View v) ( 
//Perform action on clicks, depending on whether it's now checked 
if (((CheckBox) v) .isChecked()) { 
Toast.makeText (CheckBoxRctivity.this，" 选 中 "， 
Toast .LENGTH SHORT) .show () ; 
} else { 
Toast.makeText (CheckBoxRctivity.this，" 没 选中 "， 
Toast .LENGTH SHORT) . show () ; 


) 


完成 应 用 程序 编码 后 ,不 要 忘记 要 到 AndroidManifest. xml 中 注册 才能 运行 。 

从 上 面 的 例子 可 以 看 出 ,事件 处 理 方 法 可 以 采用 与 Button 相同 的 模式 ,只 是 在 处 理 
过 程 中 ,可 以 针对 CheckBox 不 同 的 状态 进行 不 同 编码 ,实现 不 同 的 功能 。 

4. ToggleButton 和 Switch 

如 果 设 置 选项 只 有 两 种 状态 ,可 以 使 用 开关 按钮 ToggleButton( 见 图 3. 7 £A). 
Android 4. 0( API 级 别 14) 提 供 了 另外 一 种 叫做 Switch 的 开关 按钮 ,这 个 按钮 提供 一 个 
滑动 控件 ,可 以 通过 添加 Switch 对 象 来 实现 ( 见 图 3. 7 右 图 ) 。 


w E. w 


图 3.7 ToggleButton 和 Switch 


ToggleButton 和 Switch 控件 都 是 CompoundButton 组 合 按钮 的 子 类 并 且 有 着 相同 
的 功能 ,所 以 可 以 用 同样 的 方法 来 实现 它们 的 功能 。 当 用 户 选择 ToggleButtons 和 
Switch 时 ,对 象 就 会 接收 到 相应 的 单 击 事件 。 要 定义 这 个 单 击 事件 的 响应 操作 ,添加 
android:onClick 属性 到 XML 布局 文件 的 开关 按钮 控件 中 去 。 例 如 ,代码 3. 17 定义 了 一 
个 ToggleButton 开关 按钮 并 且 设置 了 android:onClick 事件 单 击 响应 属性 。 
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代码 3.17 在 布局 文件 中 定义 ToggleButton 





在 这 个 布局 对 应 的 Activity 里 ,在 android: onClick 指定 的 onToggleClicked() 方 法 
中 ,定义 事件 处 理 代码 , 见 代码 3. 18。 
代码 3.18 onToggleClicked 事件 处 理 





与 其 他 图 形 控件 一 样 , 除 了 在 布局 文件 中 定义 之 外 ,也 可 以 通过 代码 的 方式 ,为 
控件 注册 一 个 事件 监听 器 。 代 码 3. 19 中 说 明了 为 ToggleButton 注册 监听 器 的 具体 
实现 代码 : 首先 创建 一 个 CompoundButton. OnCheckedChangeListener 对 象 ,覆盖 
OnCheckedChangeListener 接口 的 抽象 方法 onCheckedChanged() ,在 其 中 具体 实现 单 击 
ToggleButton 对 象 后 的 事件 处 理 ,然后 通过 调用 此 ToggleButton 对 象 的 
setOnCheckedChangeListener() 方 法 ,将 监听 器 绑 定 到 按钮 上 , 见 代 码 3.19. 

代码 3.19 为 ToggleButton 注册 事件 监听 器 





€p 基于 Android 平台 的 移动 互联 网 应 用 开发 (第 2 版 ) 





) 
H); 


完整 的 应 用 程序 可 以 参考 CheckBox 和 RadioButton 编写 。 完 成 应 用 程序 编码 后 ， 
同样 不 要 忘记 要 到 AndroidManifest. xml 中 注册 才能 运行 。 


323 Toast 控件 


Toast 是 在 窗口 表面 弹出 的 一 个 简短 的 小 消息 ,只 填充 消息 所 需要 的 空间 ,并 且 用 户 
当前 的 Activity 依然 保持 可 见 性 和 交互 性 。 
这 种 通知 可 自动 地 淡 入 淡出 , 且 不 接受 用 户 的 
交互 事件 。 例 如 ,如 果 用 户 正 在 编写 一 封 邮件 
时 ,需要 接 通 一 个 电话 ,这 时 界面 会 弹出 一 个 
Toast 提示 ,邮件 保存 为 草稿 , 见 图 3. 8。 

Toast 是 一 个 在 屏幕 上 显示 片刻 的 提示 消 
息 , 但 是 Toast 不 能 获得 焦点 ,不 能 够 与 用 户 
进行 交互 。 我 们 可 以 自 定义 包括 图 像 的 Toast 

图 3.8 Toast 显示 布局 文件 。Toast 通知 能 够 被 Activity 或 

Service 创建 并 显示 。 如 果 创 建 了 一 个 源 自 

Service 的 Toast 通知 , 它 会 显示 在 当前 的 Activity 最 上 层 。 如 果 用 户 需要 对 通知 做 出 响 

应 ,可 以 考虑 使 用 Android 的 另 一 种 视图 对 象 状态 栏 通知 (Status Bar Notification) ,这 将 
在 后 面 的 章节 介绍 。 

如 果 要 使 用 Toast, 可 以 直接 用 Toast 类 的 方法 Toast. makeText() 实 例 化 一 个 
Toast 对 象 。 这 个 方法 有 三 个 参数 ,分 别 为 Context、 要 显示 的 文本 消息 和 Toast 通知 持 
续 显 示 的 时 间 。Toast. makeText() 方 法 会 返回 一 个 按 参数 设置 且 被 初始 化 的 Toast 对 
象 ,Toast 对 象 的 内 容 用 show() 方 法 显示 。 代 码 3. 20 示例 了 在 Activity 的 onCreate() 方 
法 中 如 何 创 建 和 显示 Toast 信息 ,在 其 他 视图 中 实现 的 代码 类 似 。 

代码 3.20 显示 Toast 通知 





Context context=getApplicationContext (); 
CharSequence text="Hello toast!"; 
int duration=Toast .LENGTH SHORT; 


Toast toast=Toast .makeText (context, text, duration); 
toast .show(); 


代码 3. 20 中 最 后 两 行 代 码 也 可 以 用 链 式 组 合 方法 写 且 避免 创建 Toast 对 象 ,代码 
如 下 : 


Toast .makeText (context, text, duration) .show(); 
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标准 的 Toast 通知 水 平 居中 显示 在 屏幕 底部 附近 。 如 果 要 把 Toast 通知 放 到 不 同 的 
位 置 显示 ,可 以 使 用 布局 文件 来 设置 Toast 对 象 的 具体 布局 ,然后 在 Activity 加 载 布局 文 
件 后 ,通过 ID 获取 Toast 对 象 ,使 用 show() 方 法 显示 其 文本 消息 。 

下 面 我 们 使 用 一 个 简单 的 例子 ,来 说 明 如 何 定义 和 使 用 Toast 自 定义 的 布局 文件 。 
要 创建 一 个 自 定义 的 布局 文件 ,可 以 在 XML 布局 文件 或 程序 代码 中 定义 一 个 View 布 
局 ,然后 把 View 对 象 传递 给 setView() 方 法 。 代 码 3. 21 中 layout. custom_toast. xml 布 
局 文件 是 专门 为 Toast 对 象 的 布局 所 做 的 定义 ,其 中 第 二 行 代码 android:id 一 "@ 十 id/ 
toast_layout_root "定义 了 这 个 Toast 布局 的 id。 这 个 是 一 个 包含 一 个 图 形 和 一 个 文本 框 
的 布局 ,其 背景 、 对 齐 方式 和 文本 颜色 也 进行 了 设置 。 

代码 3.21 Toast 自 定义 布局 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/toast layout root" 
android:orientation="horizontal" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:padding="8dp" 
android:background="#DAAA" 
> 
<ImageView android:src="@drawable/droid" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginRight="8dp" 
/> 
<TextView android:id="@+id/text" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:textColor="#FFF" 
/> 
</LinearLayout> 


Toast 的 布局 文件 创建 完成 后 ,需要 把 这 个 布局 应 用 到 用 户 界面 的 Toast 对 象 。 在 
应 用 程序 Activity 的 onCreate() 中 ,首先 导入 Activity 的 布局 资源 文件 ,然后 需要 使 用 
LayoutInflater 的 对 象 ,通过 其 inflate() 方 法 ,利用 布局 文件 名 和 布局 的 id 来 获取 布局 文 
件 中 定义 的 布局 ,下 一 步 使 用 Toast 对 象 的 setView() 方 法 使 用 这 个 布局 , 见 代 码 3. 22, 
代码 3.22 使 用 自 定义 Toast 布局 
LayoutIinflater inflater=getLayoutInflater (); 
View layout=inflater.inflate (R.layout.custom toast, 


(ViewGroup) findViewById(R.id.toast layout root)); 


TextView text= (TextView) layout.findViewById(R.id.text); 
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text.setText ("This is a custom toast"); 


Toast toast=new Toast (getApplicationContext()); 
toast.setGravity(Gravity.CENTER_VERTICAL, 0, 0); 
toast.setDuration (Toast .LENGTH LONG); 

toast .setView (layout); 

toast .show()7 


除非 使 用 setView() 方 法 设置 自 定义 布 局 ,否则 不 要 使 用 公共 的 Toast 类 构造 器 。 
如 果 不 使 用 自 定义 的 布局 , 必须 使 用 makeText (Context, int, int) 方 法 来 创建 Toast 
对 象 。 

代码 3.22 中 的 setGravity(int,int,int) 方 法 ,可 以 重新 设置 Toast 对 象 的 显示 位 置 。 
这 个 方法 有 三 个 参数 ,分 别 为 Gravity 常量 、X 轴 偏 移 量 、Y 轴 偏 移 量 。 


3.2.4 文本 控件 


Android 用 于 文本 显示 和 编辑 的 控件 主要 包括 TextView 和 EditText 两 种 。 实 际 
上 ,Android 的 很 多 控件 都 继承 自 TextView 类 ,包括 Button、CheckTextView、EditText 
等 ,但 用 于 文本 显示 时 ,常用 的 还 是 TextView 和 EditText。 因 此 这 里 我 们 主要 介绍 这 两 
个 控件 如 何 定义 和 使 用 。 

1. TextView 

TextView 是 Android 中 常用 的 组 件 之 一 ,用 于 显示 文字 ,类 似 Java 图 形 界面 里 的 
Label 标签 。TextView 中 提供 了 大 量 的 属性 用 于 设置 TextView 的 字体 大 小 、 字 体 颜 色 、 
字体 样式 等 。 由 于 很 多 控件 都 是 TextView 的 子 类 ,它们 也 继承 TextView 的 属性 ,这 给 
应 用 程序 的 界面 提供 了 多 种 显示 组 合 和 样式 。 

TextView 的 属性 可 以 直接 在 XML 布局 文件 中 设置 ,也 可 以 在 Java 应 用 程序 中 设 
置 和 修改 。 

例如 ,用 户 界面 的 布局 文件 textview_layout. xml 中 定义 了 一 个 TextView ,我 们 在 
TextView 几 个 基本 属性 基础 上 增加 几 个 属性 设置 ,如 android: textColor= " # ff0000" + 
置 字体 为 红色 ,android:textSize 二 "24sp" 设 置 字体 为 24sp,android:textStyle 二 "bold" 设 
置 字体 加 粗 。 

如 果 要 在 Java 代码 中 对 TextView 控件 属性 进行 修改 ,在 其 布局 文件 中 必须 要 给 这 
个 TextView 的 ID 属性 赋值 。TextView 的 ID 属性 是 这 个 TextView 部 件 的 唯一 标识 ， 
用 于 Java 程序 对 其 进行 引用 。 设 定 TextView 的 ID 属性 的 具体 语法 如 下 : 


android:id="@+id/textview_name" 


假设 在 textview_layout. xml 文件 中 设 定 为 android:id 王 "@ 十 id/textvw" ,没有 增加 
属性 的 设置 ,在 Java 应 用 程序 TextViewActivity 中 可 以 通过 findViewByld () 获 取 
TextView 控件 ,然后 通过 对 象 修改 其 属性 ,也 可 以 达到 同样 的 效果 , 见 代 码 3.23。 
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代码 3.23 TextViewActivity. java 


public class TextViewActivity extends Activity { 


@override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 


setContentView (R.layout.textview_layout); 


// 获 取 布 局 中 定义 的 Textview 组 件 
TextView textView= (TextView)findViewById (R.id.textvw) 
// 字 体 设 置 成 红色 


textView.setTextColor (Color .RED) 7 


// 设 置 成 24sp 


textView.setTextSize (TypedValue.COMPLEX UNIT SP, 24f); 


// 加 粗 


textView.setTypeface (Typeface.defaultFromStyle (Typeface.BOLD)); 
// 背 景 设置 成 黑色 


textView.setBackground (Color .BLACK); 


} 


通过 上 面 的 尝试 ,说 明 通过 Java 代码 程序 和 XML 布局 文件 都 可 以 实现 TextView 
属性 的 设置 。 不 过 在 Android 应 用 系统 开发 过 程 中 ,还 是 推荐 使 用 XML 进行 布局 和 界 
面 外 观 的 设计 ,使 用 Java 程序 代码 实现 程序 逻辑 。 

2. EditText 

EditText 是 Android 的 文本 编辑 框 ,是 用 户 和 Android 应 用 进行 数据 交互 的 窗口 ， 
可 以 接受 用 户 的 文本 数据 输入 ,并 将 其 传送 到 应 用 程序 中 。EditText 是 TextView 的 子 
类 ,所 以 Edit Text 继承 了 TextView 的 所 有 方法 和 所 有 属性 。 

EditText 类 似 于 Java 图 形 界面 的 文本 编辑 框 ,但 与 后 者 相 比 ,增加 从 TextView 继 
承 的 属性 之 后 ,设置 EditText 的 显示 和 输入 时 ,就 可 以 根据 不 同 的 需求 设计 出 更 加 有 个 
性 和 特点 的 交互 界面 。 例 如 ,可 以 通过 Edit Text 的 属性 设置 文本 编辑 框 的 最 大 长 度 、 空 
白 提示 文字 等 ,或 者 限制 输入 的 字符 类 型 只 能 为 电话 号 码 。 表 3. 1 列 出 了 EditText 常用 
的 一 些 属性 和 说 明 ,这些 属性 也 同样 适用 于 TextView。 


表 3.1 EditText 常用 的 属性 














属 性 说 BB 
android :editable 是 否 可 编辑 
android :gravity 设置 控件 显示 的 位 置 , 默 认 top 
android:height 设置 高 度 





android:hint 





设置 EditText 为 空 时 ,文本 提示 信息 内 容 
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续 表 
属 性 说 明 
android :imeOptions 设置 附加 功能 ,设置 右 下 角 IME 动作 与 编辑 框 相关 动作 
android :inputType 设置 文本 的 类 型 ,用 于 帮助 输入 法 显示 合适 的 键盘 类 型 
android :lines 设置 EditText 显示 的 行 数 
android :maxLength 设置 最 大 长 度 
š 设置 文本 的 最 大 显示 行 数 ,与 width 或 者 layout_width 结合 使 用 ,超出 
ene 部 分 自动 换行 ,超出 行 数 将 不 显示 
android:numeric 设置 为 数字 输入 方式 
android; password DU 82." R XK 
android; phoneNumber 设置 为 电话 号 码 的 输入 方式 
android:scrollHorizontally | 设置 文本 超出 TextView 的 宽度 时 ,是 否 出 现 横 拉 条 
android :textColor 设置 文本 颜色 
android :textColorHighlight | 设置 被 选中 后 文本 颜色 ,默认 为 蓝 色 
android :textColorHint 设置 提示 文本 颜色 ,默认 为 灰色 
android :textSize 设置 文字 大 小 ,推荐 度量 单位 sp 
android: textStyle 设置 字形 ,bold,italic,bolditalic 中 的 一 种 
android:typeface 设置 文本 字体 ,normal,sans,serif,monospace 中 的 一 种 
android: width 设置 宽度 


布局 设计 时 ,可 以 根据 需要 ,在 XML 文件 使 用 上 面 某 些 EditText 的 属性 ,来 进行 特 
殊 的 设置 。 例 如 ,要 求 EditText 中 输入 特定 个 数 的 字符 ,如 身份 证 号 .手机 号 码 等 ,可 以 
使 用 android:maxLength 一 "18" 设 定 。 下 面 给 出 一 个 例子 ,说 明 如 何 使 用 Edit Text 的 常 
用 属性 , 见 代 码 3. 24。 

代码 3.24 edittext_layout. xml 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill parent" 
android:layout height="fill parent" 


android:orientation="vertical"> 


<EditText 
android:id="@+id/edit textl" 
android:layout width="fill parent" 
android:layout height="wrap content" 


android:hint=" 请 输入 用 户 名 …" 
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编写 Java 程序 代码 ,引用 edittext_layout. xml 定义 的 布局 ,运行 应 用 就 会 看 到 Edit 
不 同 输入 类 型 显示 的 效果 ( 见 图 3. 9 左 图 ) 。 
在 应 用 程序 给 出 的 界面 上 操作 ,可 以 体验 EditText 不 同属 性 设置 对 输入 的 影响 ,了 
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图 3.9 Edit 不 同 输入 类 型 和 对 Edit 的 不 同 操作 


解 如 何 使 用 这 些 属 性 来 满足 应 用 程序 界面 输入 的 需求 。 通 过 EditText 的 其 他 属性 ,还 可 
以 进一步 修改 提示 文本 和 文本 的 字体 .颜色 和 字形 ,可 以 设置 Edit Text 是 否 可 编辑 等 。 

在 对 应 用 界面 操作 过 程 中 ,注意 在 设置 为 android:inputType 二 "phone" 的 edit_text4 
中 输入 文本 时 ,EditText 只 接受 电话 号 码 输入 的 文本 框 ,而 且 软 键盘 也 变 成 拨号 专用 软 
键盘 了 。EditText 的 android: inputType 属性 能 够 设置 为 "number" "numberSigned" 
"numberDecimal" 等 不 同 的 值 来 控制 输入 的 数字 类 型 ,分 别 对 应 integer( 正 整数 )、signed 
( 带 符 号 整数 ) 和 decimal( 浮 点 数 )。 也 可 以 通过 android:input Type 来 设置 文本 的 类 型 ， 
让 输入 法 选择 合适 的 软 键 盘 , 具 体 的 值 可 以 查 EditText 在 http://developer. android. 
com/reference/android 的 文档 。 

在 android:inputType 属性 设 定 输入 的 文本 类 型 后 , 软 键盘 的 转换 是 自动 的 。 除 了 
这 个 属性 之 外 ,EditText 的 android:imeOptions 属性 也 可 以 对 软 键盘 进行 控制 ,通过 不 
同 的 值 ,在 Enter 键 的 位 置 显 示 出 不 同 的 按钮 ,例如 “完成 ”搜索 ”去 往 ? 等 。 下 面 是 
android:imeOptions 的 几 个 常用 的 常量 值 , 其 值 不 同 , 软 键盘 显示 的 按钮 也 不 同 。 

e actionUnspecified: Enter 按钮 。 
actionGo: Go 按钮 。 
actionSearch: Search 按钮 。 
actionSend: Send 按钮 。 
actionNext: Next 按钮 。 

。 actionDone: Finish 按钮 。 

除了 输入 和 对 软 键盘 的 控制 之 外 ,EditText 对 输入 后 的 文本 操作 也 很 灵活 ,Android 
为 Edit Text 定义 了 很 多 处 理 方法 ,能 够 实现 取 值 ,全 选 、 部 分 选择 、 获 取 选 中 文本 。 获 取 
文本 的 操作 在 Java 程序 代码 中 实现 ,由 事件 处 理 器 根据 不 同 的 操作 ,对 文本 进行 不 同 的 
处 理 。 下 面 通过 一 个 例子 来 说 明 如 何 对 Edit Text 输入 的 文本 进行 取 值 .全 选 、 部 分 选择 





第 3 章 Fragment 和 图 形 控件 `e 


和 获取 选中 文本 , 见 图 3.9 右 图 。 


界面 的 XML 布局 文件 可 以 参考 前 面 的 内 容 , 在 纵向 线性 布局 中 设置 界面 显示 的 控 
件 ,其 中 EditText 的 属性 android:imeOptions 设置 为 "actionSearch" ,基于 监听 器 的 事件 
处 理 具体 实现 见 代码 3.25, 

代码 3.25 EditTextSearchActivity. java 
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3.2.5 ImageView 控件 


ImageView 控件 是 Android 用 于 显示 图 片 的 控件 ,可 以 用 于 显示 来 自 资源 文件 、 
Drawable 对 象 .Bitmap 对 象 或 ContentProvider 的 URI 等 不 同 来 源 的 图 片 ,并 能 够 通过 
各 种 属性 来 控制 图 片 的 各 种 显示 选项 ,例如 缩放 和 着 色 等 。ImageView 的 属性 可 以 直接 
在 XML 布局 文件 中 设置 ,也 可 以 在 Java 应 用 程序 中 设置 和 修改 。ImageView 是 View 的 
子 类 ,具有 View 的 属性 , 它 在 XML 布局 文件 中 的 设置 与 Text View 类 似 , 见 代码 3. 26 。 

代码 3.26 在 定义 XML 文件 中 ImageView 
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android:layout width="wrap content" 
android:;layout height="wrap content" 
android:scaleType="center" 
android:src="@drawable/my_image" /> 


</LinearLayout> 


在 使 用 ImageView 的 过 程 中 ,一 般 会 遇 到 两 个 问题 : 

一 是 在 使 用 ImageView 显示 图 片 时 ,使 用 android: src 属性 设置 图 片 的 来 源 , 默 认 状 
态 下 ,运行 时 图 形 显示 效果 会 有 明显 的 边界 ,无 法 使 图 片 充满 整个 ImageView。 解 决 方法 
是 ,把 android: src 属性 设置 图 片 源 这 条 语句 , 改 为 android: background = " @ drawable/ 
my_image" 。 

另 一 个 问题 是 如 何 通过 ImageView 的 属性 ,来 控制 原始 图 片 的 尺寸 .比例 或 者 显示 
位 置 , 以 匹配 ImageView 本 身 设 置 的 大 小 ,运行 时 显示 出 设计 预想 的 效果 。 解 决 方法 是 ， 
使 用 Image View 最 重要 的 一 个 属性 android:scaleType, 根 据 需 要 设置 对 应 的 值 。 表 3. 2 
中 列 出 了 ScaleType 的 属性 值 和 对 应 的 含义 。 

表 3.2 ScaleType 属性 值 
属 性 值 含 x 
CENTER 图 片 居中 显示 ,不 执行 缩放 ,图 片 大 时 会 被 裁减 
CENTER_CROP | 按照 比例 对 图 片 进行 缩放 ,充满 InageView 控件 ,居中 显示 , 截 除 图 片 多 余部 分 


图 片 比 ImageView 大 , 则 根据 比例 对 图 片 进行 缩小 并 将 其 居中 显示 ;图 片 比 
ImageView 小 , 则 不 对 图 片 进行 处 理 , 直 接 居中 显示 


FIT_CENTER 按照 比例 对 图 片 进 行 缩放 ,并 将 图 片 居中 显示 











CENTER_INSIDE 

















FIT_END 按照 比例 对 图 片 进行 缩放 ,将 图 片 放置 到 右 下 角 
FIT_START 按照 比例 对 图 片 进行 缩放 ,将 图 片 放置 到 左下 角 
FIT_XY 拉 伸 或 收缩 图 片 ,不 保持 原 比例 

MATRIX 从 左上 角 开 始 绘制 图 片 ,超过 ImageView 的 部 分 截 掉 








图 3. 10 所 示 的 8 幅 小 图 显示 了 比 ImageView 小 的 图 片 ,在 不 同 ScaleType 属性 的 
ImageView 中 显示 的 效果 。 这 个 例子 中 Activity 中 设计 了 一 个 ImageView 和 一 个 
Button , 单 击 Button 可 以 转换 ImageView 的 ScaleType 属性 ,并 把 这 个 属性 值 标注 在 
Button E. 

这 个 例子 的 XML 布局 文件 可 以 参考 前 面 的 例子 编写 。 其 中 原始 图 片 是 160 X 240 
像素 ,ImageView 的 尺寸 设置 成 android: layout _width 的 值 为 "match_parent",android; 
layout_height 的 值 为 "400dp"。ImageView 的 单 击 事件 通过 android: onClick 属性 设置 
回调 方法 changeScale() ,使 用 ImageView 的 setScaleType() 方 法 实现 其 ScaleType 的 
值 ,从 而 改变 用 户 界面 中 图 形 的 显示 效果 , 见 代码 3. 27。 
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图 3.10 不 同 ScaleType 属性 的 ImageView 显示 效果 


代码 3.27 改变 事件 处 理 


public class ImageScaleActivity extends AppCompatActivity { 
Button btn; 
ImageView img; 
ImageView.ScaleType 
scale[]=(ImageView.ScaleType.CENTER, **, ImageView.ScaleType.MATRIX}; 
// 属 性 值 
String scalestr[]=( "CENTER", ++, "MATRIX"}; // 对 应 字符 串 
int scaleIdx=07 


public void changeScale (View view)( 
scaleIdx++; 
scaleIdx=scaleIdx%scale.length; 
img.setScaleType (scale[scaleIdx]); 
btn.setText (scalestr[scaleIdx]); 


3.2.6 ProgressBar 控件 


进度 条 是 在 UI 进 程 中 显示 工作 进程 进度 的 一 个 重要 工具 。ProgressBar 是 Android 
提供 的 一 个 进度 条 类 型 ,表示 运转 的 过 程 ,例如 发 送 短信 、 连 接 网 络 等 ,表示 一 个 过 程 正在 
执行 中 。ProgressBar 的 样式 主要 有 普通 圆 形 、 大 号 圆 形 、 小 号 圆 形 和 标题 型 圆 形 等 。 
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1. 普通 圆 形 


对 于 进度 条 的 样式 一 般 只 要 在 XML 布局 中 定义 就 可 以 了 。 


此 时 ,没有 设置 它 的 风格 ,那么 它 就 是 圆 形 的 一 直 会 旋转 的 进度 条 。 

2. 大 号 圆 形 

如 果 给 进度 条 设置 一 个 style 风格 属性 后 ,该 ProgressBar 就 有 了 一 个 风格 ,这 里 大 
号 ProgressBar 的 风格 是 : 


3. 小 号 圆 形 
小 号 ProgressBar 对 应 的 风格 是 : 


4. 标题 型 圆 形 
标题 型 ProgressBar 对 应 的 风格 是 : 





下 面 使 用 ProgressBar 实现 进度 条 显示 的 例子 , 见 代 码 3.28 和 3. 29, 
代码 3. 28 ProgressBarActivity. java 
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代码 3.29 progressbar_activity. xml 





3.3 界面 效果 处 理 


Android 的 API 中 提供 了 一 些 特殊 的 界面 效果 处 理 方法 ,下 面 介绍 这 些 方法 。 


3.3.1 文本 处 理 


在 Android 中 ,有 时 候 需 要 对 文本 进行 各 种 特别 的 设置 ,如 颜色 、 大 小 、 首 行 缩 进 ,或 
者 是 在 一 段 文本 中 加 入 图 片 ,甚至 是 书写 一 些 特殊 的 公式 。 如 果 通 过 布局 文件 使 用 多 个 
控件 来 实现 ,一 方面 使 用 起 来 特别 复杂 ,增加 了 布局 文件 维护 的 难度 , 另 一 方面 ,如 果 加 入 
了 太 多 的 控件 ,在 页 面 加 载 时 也 要 耗费 更 多 的 资源 。 在 HTML 中 ,可 以 使 用 各 种 标签 来 
实现 这 些 特殊 效果 ,而 在 Android 中 有 类 似 的 机 制 , 只 不 过 不 是 使 用 标签 来 实现 ,而 是 使 
用 Spannable 对 象 来 实现 。 
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332 ”定义 链接 


在 传统 的 HTML 网 页 中 ,加 一 个 二 a 二 标记 就 可 以 让 一 段 文字 变 成 超 链接 的 形式 ， 
可 以 单 击 到 链接 的 地 址 。 在 Android 界面 中 也 能 提供 类 似 的 功能 。Android 界面 的 大 多 
数 文本 一 般 通 过 TextView 对 象 来 显示 ,TextView 的 android:autoLink 属性 设置 可 以 实 
现 这 个 功能 。 如 果 某 个 TextView 的 android; autoLink 属性 设置 成 "web", 则 该 
TextView 中 网 址 形式 的 字符 就 会 自动 变 成 超 链接 的 形式 。 下 面 使 用 一 个 简单 的 例子 来 
说 明 设 置 的 过 程 。 

首先 在 /res/values/String. xml 中 定义 一 个 字符 串 , 见 代码 3. 30。 

代码 3.30 定义 字符 串 资源 


<string name="taobao_Mcommerce_ android"> 移 动 电子 商务 开发 实践 : http://code. 
google.com/p/taobao- sdk- for-android-platform/</string> 


然后 ,在 /res/layout/main. xml 布局 文件 中 ,把 TextView 的 android:autoLink 属性 
设置 成 "web", 见 代码 3. 31。 
代码 3.31 设置 TextView 的 链接 属性 


<?xm1 version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 


android:orientation="vertical"> 


<TextView 
android:id="@+id/textView" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:autoLink="web" 
android:text="@string/taobao Mcommerce android" 
android:textColor="#ff0000" 
android:textSize="24sp" 
android:textStyle="bold" /> 


</LinearLayout> 


android :autoLink 的 值 还 可 以 是 "phone" 或 "email" ,可 以 将 字符 串 中 的 电话 或 邮件 
地 址 设置 成 超 链 接 ,如果 将 这 个 值 设置 为 "all" , 则 对 上 述 三 种 类 型 的 字符 串 都 设置 成 超 
链接 。 
3.3.3 文本 样式 

有 时 候 ,我 们 需要 对 文本 显示 的 样式 进行 一 些 特殊 的 设置 ,例如 突出 显示 View 中 部 


` `Z 
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分 内 容 , 可 以 使 用 Android 的 文本 样式 设置 来 完成 。Android 的 文本 设置 样式 可 以 使 用 
静态 或 动态 方式 设置 内 容 的 样式 。 

1. 静态 方式 设置 文本 样式 

静态 的 方式 是 直接 在 /res/values/string. xml 中 定义 一 个 字符 串 变 量 ,并 指定 其 内 
容 。 如 下 所 示 : 





<string name="styledText"> 在 <b>TextView</b> 中 设置 <i> 静 态 </i> 样 式 
</string> 


字符 串 定义 好 后 ,就 可 以 在 XML 布局 文件 或 应 用 程序 代码 中 引用 这 个 字符 串 资 源 
了 。 在 字符 串 定义 时 ,可 以 使 用 XML 的 标签 。 例 如 ,二 i 汪 >、 二 b 二 和 二 u 二 分 别 代表 和 斜 
IK AEA F SJ R, £ n] D) E Jj < sup >. < sub >, < strike >, < big >, < small > #ll 
<monospace> FHE. EER ERLA EME TextViews 上 ,而 且 对 其 他 View 也 起 
作用 。 

使 用 Activity 导入 代码 3. 32 中 的 布局 文件 ,查看 显示 内 容 可 知 , 在 字符 串 中 定义 的 
格式 效果 完全 显示 出 来 。 

代码 3.32 带 样 式 的 布局 文件 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 


android:orientation="vertical"> 


<TextView 
android:id="@+id/tvStyled" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/styledText" 
android:typeface="monospace" /> 


<Button 
android:id="@+id/buttonl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="@string/italics" 
android:typeface="monospace" /> 


</LinearLayout> 


2. 动态 方式 设置 文本 样式 
动态 方式 设置 文本 样式 ,也 就 是 通过 应 用 程序 代码 编程 的 方式 ,来 设置 或 改变 
TextView 中 的 显示 内 容 的 格式 。 这 种 方式 比 静 态 方式 要 复杂 ,但 是 更 具 灵活 性 。 
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如 果 要 动态 设置 文本 样式 ,首先 要 将 Text View 中 显示 的 内 容 设 置 为 Spanable 对 象 ， 
代码 如 下 : 


tv.setText (" 字 符 串 "，TextView.BufferTyPe.SPRNNRBLE) ; 


通过 上 面 的 设置 , TextView 中 的 内 容 被 存储 成 Spannable 对 象 ,然后 就 可 以 使 用 
TextView 的 getText() 方 法 获取 Spannable 对 象 了 。 具 体 获 取 Spannable 对 象 的 代码 
如 下 : 


Spannable spn= (Spannable) tv.getText (); 


也 可 以 先 创建 一 个 SpannableString 对 象 , 然 后 使 用 Text View 的 setText() 方 法 将 
这 个 对 象 传递 给 TextView。 代 码 如 下 : 


SpannableString msp=new SpannableString ("字符 串 "); 
tv.setText (msp); 


获取 或 创建 Spannable 对 象 以 后 ,就 可 以 使 用 Spannable 类 提供 的 setSpan (Obj 
what,int start,int end,int flags) 方 法 来 进行 样式 的 设置 。setSpan( ) 方 法 的 参数 说 明 如 
下 : what 是 具体 样式 对 象 , 所 实现 的 类 都 在 android. text. style 包 中 ;start 则 是 该 样式 开 
始 的 位 置 ;end 对 应 的 是 样式 结束 的 位 置 ;参数 flags 定义 在 Spannable 中 的 常量 。 常 用 
的 有 : 


Spanned. SPAN_EXCLUSIVE_EXCLUSIVE, 不 包含 两 端 start 和 end 所 在 的 端 
点 ,可 表示 为 (a,b)。 

Spanned. SPAN_EXCLUSIVE_INCLUSIVE ,不 包含 端 start, 但 包含 end 所 在 的 
端点 ,可 表示 为 (a,b]。 

Spanned. SPAN_INCLUSIVE_EXCLUSIVE ,包含 两 端 start, 但 不 包含 end 所 在 
的 端点 ,可 表示 为 La,b) 。 

Spanned. SPAN_INCLUSIVE_INCLUSIVE ,包含 两 端 start 和 end 所 在 的 端点 ， 
可 表示 为 La,b]。 

例如 ,设置 文本 字符 串 的 第 2.3 个 字符 显示 为 粗 斜 体 的 代码 如 下 : 


msp.setSpan (new StyleSpan (android. graphics.Typeface.BOLD ITALIC), 0, 4, 
Spannable.SPAN EXCLUSIVE EXCLUSIVE); 


Spannable 类 与 StyleSpan 类 具有 类 似 作 用 ,用 来 构建 样式 的 其 他 类 都 在 android. 
text. style 包 下 ,其 中 还 包括 : 
。 AbsoluteSizeSpan ,是 指 绝对 尺寸 ,通过 指定 绝对 尺寸 来 改变 文本 的 字体 大 小 。 
。 BulletSpan,BulletSpan ,着 重 样式 ,类似 于 HTML 中 的 一 1i 盖 标签 的 圆 点 效果 。 
。 ForegroundColorSpan ,字体 颜 色 样式 ,用 于 改变 字体 颜色 。 
代码 3. 33 中 示例 了 使 用 动态 方式 设置 一 个 字符 串 中 不 同 字符 不 同样 式 的 用 法 ,显示 
效果 见 图 3. 11。 
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代码 3.33 设置 文本 外 观 
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spn.setSpan (new UnderlineSpan () , 39, 42, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 


// 设 置 删除 线 
spn .setSpan (new StrikethroughSpan(), 43, 46, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 


// 设 置 上 下 标 
spn.setSpan (new SubscriptSpan (), 47, 49, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); // 下 标 
spn.setSpan (new SuperscriptSpan(), 50, 52, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); // 上 标 
// 设 置 项 目 符号 
spn.setSpan (new BulletSpan ( 
android.text.style.BulletSpan.STANDARD GAP WIDTH, Color. 
GREEN), 62, spn.length(), Spanned.SPAN EXCLUSIVE EXCLUSIVE); 


} 


运行 后 显示 如 图 3. 11 所 示 。 
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图 3.11 各 种 格式 的 文本 


334 切换 绘图 


Android 的 视图 对 象 在 应 用 过 程 中 ,存在 不 同 的 状态 。 例 如 按钮 ,具有 单 击 按 下 、 获 
得 焦点 或 正常 情况 等 状态 。 根 据 控件 的 状态 ,StateListDrawable 对 象 可 以 使 用 几 种 不 同 
的 图 像 来 为 控件 指定 背景 图 片 ,这 称 为 切换 绘图 。 实 现 切 换 绘图 有 两 种 方式 : XML 文件 
定义 和 应 用 程序 定义 。 

1. 使 用 XML 文件 定义 状态 选择 列表 

一 般 来 说 ,首先 要 使 用 XML 文件 定义 状态 选择 列表 。 这 个 文件 需要 创建 在 res 目录 
下 的 drawable 文件 夹 中 。 在 一 个 XML 状态 列表 文件 中 只 有 一 个 二 selector 志 元素 ,其 中 
包含 多 个 二 item 过 元素, 用 来 定义 状态 及 其 对 应 的 图 片 。 代 码 3. 34 中 示例 了 一 个 状态 选 
择 列 表 定 义 的 语法 。 
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代码 3.34 状态 选择 列表 定义 


<?xm1 version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state pressed="true" 
android:drawable="@ drawable/button pressed" /><!--pressed--> 
<item android:state focused="true" 
android:drawable="@ drawable/button focused" /><!--focused--> 
<item android:state hovered="true" 
android:drawable="@drawable/button focused" /><!--hovered--> 
<item android:drawable="@drawable/button normal" /><!--default--> 


</selector> 


二 item 放 元 素 通过 属性 定义 显示 图 片 时 的 状态 。 代 码 3.34 定义 了 四 种 状态 ,其 中 
包括 : 

1) android:state_pressed 

其 值 为 布尔 型 ,如 果 为 "true", 当 对 象 被 按 下 (例如 触摸 / 单 击 一 个 按钮 ) 使 用 此 选项 ; 
WRH" false" , 当 处 于 没有 按 下 状态 时 ,默认 设置 使 用 此 选项 。 

2) android:state_focused 

其 值 为 布尔 型 ,如 果 为 "true", 当 对 象 拥有 输入 焦点 时 应 使 用 此 选项 (例如 当 用 户 选 
择 一 个 文本 输入 ) 使 用 此 选项 ;如 果 为 "false" , 当 处 于 没有 焦点 状态 时 ,默认 设置 使 用 此 
选项 。 

3) android:state_hovered 

其 值 为 布尔 型 ,如 果 为 "true", 当 游标 悬浮 在 对 象 之 上 时 ,使 用 此 选项 ; 如 果 为 
"false" ,不 是 处 于 游标 悬浮 状态 ,默认 使 用 此 选项 。 通 常 ,这 种 此 选项 使 用 的 图 片 与 焦点 
状态 的 选项 相同 。 

4) 默认 状态 

当 控件 的 状态 发 生变 化 时 ,Android 会 从 第 一 个 <<item> 元 素 开始 查找 ,匹配 当前 状 
态 的 二 item 二 元 素 被 选中 ,这 种 选择 不 是 基于 最 佳 匹配 的 方式 ,只 要 求 符合 当前 状态 的 最 
IRRE. <item> Ji {EJ android: drawable 属性 指定 一 个 图 片 资 源 ,这 个 属性 是 必 
要 的 。 

假设 代码 3. 34 定义 的 状态 选择 列表 文件 名 为 button_bg. xml, 在 布局 文件 中 可 以 直 
接 引 用 代码 3. 34 定义 的 资源 , 见 代 码 3. 35。 

代码 3.35 引用 状态 列表 


<Button 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:background="@ drawable/button bg" /> 


2. 在 应 用 程序 中 实现 切换 绘图 
也 可 以 使 用 编码 的 方式 实现 上 面 的 功能 , 见 代 码 3. 36。 
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代码 3.36 ”使 用 代码 实现 绘图 切换 





除了 Button 之 外 ,还 可 以 类 似 的 方式 给 其 他 的 视图 对 象 指定 不 同 状态 的 背景 。 
335 又 加 绘图 


在 用 户 界面 显示 图 形 或 图 像 时 ,使 用 LayerDrawable 对 象 可 以 将 多 个 绘图 资源 按照 
顺序 层 释 起 来 ,最 后 一 个 绘图 资源 将 会 被 放 在 最 上 面 ,呈现 出 芭 加 视图 的 效果 。 实 现 羡 加 
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视图 ,同样 可 以 通过 两 种 方式 来 实现 : XML 文件 和 应 用 程序 代码 。 

LayerDrawable 可 以 通过 XML 文件 定义 ,这 个 XML 文件 需要 保存 在 res/ drawable/ 
文件 夹 中 。 其 根 元 素 为 layerlist 之 ,其 中 包含 多 个 天 item> 子 元 素 , 代 码 3. 37 是 一 个 
定义 释 加 绘图 资源 的 XML 文件 例子 。 

代码 3.37 定义 到 加 绘图 资源 


<?xml version="1.0" encoding="utf-8"?> 
<layer-list xmlns:android="http://schemas.android.com/apk/res/android"> 
<item> 
<bitmap android:src="@drawable/android red" 
android:gravity="center" /> 
</item> 
<item android:top="10dp" android:left="10dp"> 
<bitmap android:src="@drawable/android_green" 
android:gravity="center" /> 
</item> 
<item android:top="20dp" android:left="20dp"> 
<bitmap android:src="@drawable/android blue" 
android:gravity="center" /> 
</item> 


</layer-list> 


代码 3.38 定义 了 三 个 绘图 资源 的 从 加 ,最 后 定义 
的 绘图 资源 显示 在 最 上 面 。 二 item 放 元 素 可 以 定义 绘 
图 资源 在 四 个 方向 的 偏 移 量 ,其 属性 分 别 为 android: 
left.android: right, android: top 和 android: bottom, 
在 默认 情况 下 ,所 有 的 绘图 资源 都 会 发 生 缩 放 以 适应 
包含 其 容器 的 尺寸 。 假 设 代码 3. 38 文件 名 为 image_ 
layers. xml, 在 布局 文件 中 ,可 以 在 定义 一 个 
ImageButton 时 引用 , 见 代 码 3. 39。 显 示 效 果 见 
Bl 3.12, 
代码 3.38 引用 图 形 又 加 资源 





3.12 礁 加 的 图 形 显示 效果 


<ImageView 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:id="@+id/imgView" 


android:src="@drawable/image layers" /> 


图 3. 12 的 效果 也 可 以 通过 应 用 程序 代码 来 实现 。 


3 395 Famen 和 图 形 控件 





代码 3.39 在 应 用 程序 中 设置 到 加 绘图 


BitmapDrawable dl= (BitmapDrawable) getResources () .getDrawable ( 
R.drawable.android); 

dl.setGravity(Gravity.CENTER) 7 

BitmapDrawable d2= (BitmapDrawable) getResources () .getDrawable ( 
R.drawable.android focused); 

dl.setGravity (Gravity.CENTER); 

BitmapDrawable d3= (BitmapDrawable) getResources () .getDrawable ( 
R.drawable.android pressed); 

d3.setGravity (Gravity.CENTER); 

Drawable drawableArray[]=new Drawable[] { dl, d2, d3 }; 

LayerDrawable layerDraw=new LayerDrawable (drawableArray); 

layerDraw.setLayerInset (1, 10, 10, 0, 0);//set offset of 2 layer 

layerDraw.setLayerInset (2, 20, 20, 0, 0);//set offset for third layer 

ImageView imageView= (ImageView) findViewById(R.id.imgView); 

imageView.setImageDrawable (layerDraw); 


336 切换 颜色 


Android 的 视图 对 象 不 仅 可 以 根据 状态 定义 切换 的 图 形 ,还 可 以 定义 切换 的 颜色 。 
根据 控件 的 状态 ,Android 使 用 ColorStateList 对 象 可 以 为 控件 定义 几 种 不 同 的 颜色 。 同 
样 ,定义 切换 的 颜色 可 以 有 使 用 XML 文件 定义 和 程序 代码 实现 两 种 方式 。 

切换 颜色 的 状态 列表 也 是 通过 XML 文件 定义 的 方式 ,与 实现 切换 图 片 效 果 的 方式 
类 似 , 都 是 通过 一 selector 过 生 item 过 元 素来 定义 的 。 不 同 之 处 是 切换 颜色 必须 定义 
—item>Éf android: color 属性 ,其 属性 值 为 十 六 进 制 颜色 ,使 用 RGB 值 来 指定 ,并 且 可 
选择 Alpha 通道 。RGB 值 始终 使 用 # 字 符 开头 ,后 面 跟 Appha-Red-Green-Blue 信息 , 格 
式 可 以 为 #RGB、# ARGB, # RRGGBB 和 #AARRGGBB。 例 如 代码 3. 40 定义 了 三 种 
状态 对 应 三 种 颜色 。 

代码 3.40 定义 三 种 状态 和 颜色 


<?xml version="1.0" encoding="utf-8"?> 


<selector xmlns:android="http://schemas.android.com/apk/res/android"> 


<item android:state pressed="true" android:color="#ffff0000"/> 
<!--pressed--> 

<item android:state_focused="true" android:color="#ff0000ff"/> 
<!-~focused--> 

<item android:color="#ff00ff00"/> 
<!=—=default-—-> 


</selector> 
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另 一 个 与 切换 绘图 设置 的 不 同 之 处 在 于 ,XML 定义 文件 的 位 置 位 于 res/color/ 文 件 
夹 中 。 假 设 代 码 3. 41 的 文件 名 为 edittext_color. xml, 如 果 要 在 布局 文件 中 的 两 个 
EditText 控件 引用 这 个 资源 文件 ,直接 使 用 android:textColor 属性 , 见 代 码 3. 41。 

代码 3.41 在 布局 文件 中 引用 


<EditText 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="text01" 
android:textColor="@color/edittext_color" /> 


<EditText 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="text02" 
android:textColor="@color/edittext_color" /> 


创建 一 个 例子 Activity, FAAR 3. 41 中 定义 的 布局 资源 文件 ,尝试 分 别 单 击 这 两 
个 EditText, 查 看 改变 焦点 后 文本 颜色 会 发 生 什 么 变化 。 


3.4 Á = J Z 


本 章 主要 分 为 三 个 部 分 。 第 一 部 分 介绍 了 Fragment 的 概念 ,Fragment 的 生命 周期 
以 及 使 用 Fragment 静态 创建 和 动态 创建 用 户 界面 的 具体 步 又 和 代码 。 第 二 部 分 介绍 了 
Android 用 户 界 面 的 事件 处 理 机 制 和 一 些 常 用 控件 的 用 法 。Android 用 户 界 面 的 事件 处 
理 机制 有 两 种 ,基于 监听 接口 和 基于 回调 机 制 。 对 于 常用 控件 ,使 用 简单 的 例子 说 明了 按 
HIEN Toast, 文本 控件 .ImageView 和 ProgressBar 控件 的 使 用 ,包括 它们 的 布局 属性 
以 及 基于 监听 接口 的 事件 处 理 机 制 。 第 三 部 分 是 界面 效果 处 理 的 使 用 ,说 明了 文本 特殊 
格式 、 切 换 绘图 、 释 加 绘图 和 切换 颜色 如 何 通 XML 文件 和 应 用 程序 来 实现 。 
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菜单 和 动作 条 


设计 应 用 程序 的 浏览 模式 是 完善 用 户 体验 需要 考虑 的 重要 一 环 。 如 果 浏 览 模式 设计 
的 不 佳 ,用 户 无 法 快速 定位 所 需 的 功能 ,或 者 出 现 错误 定位 使 用 户 无 法 得 到 所 需 的 功能 ， 
这 些 都 会 产生 不 好 的 用 户 体 验 。 从 Android 3.0 开始 ,Android 系统 的 应 用 浏览 模式 发 生 
了 较 大 的 改变 ,引入 了 向 上 和 返回 的 设计 原则 ,并 且 提 供 了 相应 的 设计 组 件 , 其 中 包含 菜 
单 , 动 作 条 和 浏览 抽 居 等 。 如 果 要 实现 准确 的 一致 的 应 用 程序 浏览 ,还 需要 理解 浏览 模 
式 的 原则 ,并 且 学 会 组 件 的 使 用 。 


4.1 菜单 模式 


在 Android 中 ,支持 菜单 视图 元 素 的 关键 类 是 android. view. Menu, 每 个 Activity 都 
会 关联 一 个 这 种 类 型 的 菜单 对 象 。 一 个 菜单 对 象 包含 了 一 些 菜单 项 和 子 菜单 。 菜 单项 由 
android. view. Menultem 类 表示 , 子 菜单 由 android. view. SubMenu 类 表示 。 菜 单项 具有 
的 属性 包括 名 称 、 菜 单项 ID、 分 组 ID 顺序 等 。 

菜单 的 定义 与 用 户 界面 的 其 他 可 视 控件 类 似 ,可 以 通过 XML 文件 定义 菜单 资源 , 保 
存在 res 目录 下 的 menu 文件 夹 中 ,在 Java 程序 中 可 以 通过 ID 来 获取 定义 的 对 象 ,进行 
操作 。 定 义 菜单 资源 的 语法 见 代 码 4. 1 示例 。 

代码 4.1 定义 菜单 资源 的 语法 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@ [+] [package:]id/resource name" 

android:title="string" 
android:titleCondensed="string" 
android:icon="@ [package:]drawable/drawable resource name" 
android:onClick="method name" 
android:showAsAction=["ifRoom" | "never" | "withText" | "always" | 
"collapseActionView"] 
android:actionLayout="@ [package:]layout/layout resource name" 
android:actionViewClass="class name" 
android:actionProviderClass="class name" 
android:alphabeticShortcut="string" 
android:numericShortcut="string" 


android:checkable=["true" | "false"] 
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android:visible=["true" | "false"] 
android:enabled= ["true" | "false"] 
android:menuCategory= ["container" | "system" | "secondary" 
"alternative"] 
android:orderInCategory="integer" /> 
<group android:id="@ [+] [package:]id/resource name" 
android:checkableBehavior=["none" | "all" | "single"] 
android:visible= ["true" | "false"] 
android:enabled= ["true" | "false"] 
android:menuCategory=["container" | "system" | "secondary" 
"alternative"] 
android:orderInCategory="integer"> 
<item /> 
</group> 
<item> 
<menu> 
?<itenm /> 
</menu> 
</item> 


</menu> 


4.1.1 菜单 资源 


对 于 所 有 类 型 的 菜单 ,Android 提供 了 标准 的 XML 格式 来 定义 菜单 项 ,所 以 除了 在 
代码 中 实例 化 菜单 之 外 ,还 可 以 在 一 个 XML 菜单 资源 中 定义 菜单 和 菜单 项 ,然后 在 
Activity 中 使 用 资源 ID 加 载 菜单 资源 。 使 用 XML 资源 来 定义 菜单 是 一 种 推荐 的 方式 。 
使 用 XML 资源 来 定义 菜单 有 许多 优点 ,例如 可 以 更 好 地 体现 菜单 的 结构 ,可 以 使 迎 辑 代 
码 和 菜单 内 容 分 离 ,可 以 为 不 同 的 平台 版 本 、 不 同 的 屏幕 尺寸 等 提供 可 以 蔡 换 的 菜单 配 
置 。 代 码 4. 1 给 出 了 使 用 XML 文件 定义 菜单 资源 的 示例 ,下 面 针 对 XML 文件 定义 菜单 
资源 时 使 用 的 元 素 进行 说 明 。 

。 二 menu 二 。 此 元 素 用 来 定义 菜单 ,用 来 包含 菜单 项 。 必 须 有 一 个 一 menu 二 元 素 作 
为 菜单 资源 XML X fF ñJ 8 pú 3 , Jt rh n] D) tg @ — sÑ # 4° <item> #l< group> 
元 素 
< 一 item 之 。 此 元 素 用 来 定义 菜单 项 ,每 个 <item 之 都 表示 一 个 菜单 项 ,而 且 其 还 
可 以 包含 一 个 内 肉 的 二 menu 二 元 素 ,用 来 创建 子 菜单 。 

去 group 之 。 此 元 素 是 可 选 的 .不 可 见 的 ,可 以 用 来 对 菜单 项 进行 分 类 ,目的 是 使 
它们 可 以 共享 相同 的 属性 ,例如 激活 状态 和 可 见 性 。 

另外 ,经 常 使 用 下 面 几 种 天 item> 元 素 属性 来 定义 菜单 项 的 显示 和 行为 : 

e android:id。 表 示 菜 单项 的 唯一 资源 ID, 用 来 识别 菜单 项 。 

。 android:icon。 表 示 菜 单项 的 显示 图 标 , 可 以 指定 一 个 图 片 资源 。 

e android:title。 表 示 菜 单项 的 显示 标题 ,这 里 指定 一 个 字符 串 资源 。 
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例如 ,代码 4. 2 定义 了 一 个 简单 的 菜单 资源 XML 文件 game_menu. xml, 其 中 使 用 
T <menu> .<item>>36# f#ll<item>>3ú # BJ — E J8š PE , 
代码 4.2 简单 的 菜单 资源 文件 





<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/new_game" 
android:icon="@drawable/ic_new_game" 
android:title="@string/new_game" 
android:showAsAction="ifRoom"/> 
<item android:id="@+id/help" 
android:icon="@drawable/ic_help" 
android:title="@string/help" /> 
</menu> 


如 果 需 要 增加 子 菜单 ,需要 在 二 item 二 元素 中 包含 一 menu 过 元素 , 子 菜单 可 以 起 到 
将 应 用 程序 功能 按照 主题 进行 分 类 的 作用 。 例 如 ,在 Microsoft Office 套件 应 用 的 菜单 条 
中 都 有 “文件 ”“ 编 辑 ” 等 子 菜单 。 

子 菜 单 中 菜单 选项 的 定义 与 菜单 类 似 , 元 素 和 属性 的 应 用 也 相同 ,代码 4. 3 给 出 了 使 
用 XML 资源 文件 定义 子 菜单 的 简单 例子 。 

代码 4.3 使 用 XML 文件 定义 子 菜单 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/file" 
android:title="@string/file"> 
< !=— "file" submenu==> 
<menu> 
<item android:id="@+id/create_new" 
android:title="@string/create_new" /> 
<item android:id="@+id/open" 
android:title="@string/open" /> 
< /menu> 
</item> 


</menu> 


菜单 项 目 在 菜单 列表 的 排列 顺序 由 android: orderInCategory 和 android: 
menuCategory 两 个 属性 值 之 和 确定 的 。 数 值 之 和 越 小 排列 越 靠 前 ,表示 更 重要 。 例 如 一 
个 菜单 项 排列 顺序 为 4 和 另 一 个 菜单 项 排列 顺序 数 为 6, 如果 为 列表 形式 排列 的 菜单 ,第 
一 菜单 项 将 出 现在 第 二 个 菜单 项 的 上 面 ;如 果 为 六 项 形式 排列 的 菜单 ,第 一 菜单 项 将 出 现 
在 第 二 个 菜单 项 的 左边 。android:menuCategory 被 称 为 菜单 类 别 属性 ,包含 了 四 种 预定 
义 数值 ,分别 为 : 

。 container。 表 示 菜 单 类 别 从 0x10000 开始 ,由 常量 Menu. CATEGORY _ 


MA 
> 于 一 
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CONTAINER 定义 。 
system。 表 示 菜 单 类 别 从 0x20000 开始 ,由 常量 Menu. CATEGORY_SYSTEM 
定义 。 
secondary。 表 示 菜 单 类 别 从 0x30000 开始 ,由 常量 Menu. CATEGORY _ 
SECONDARY 定义 。 
alternative。 表 示 菜 单 类 别 从 0x40000 开始 ,由 常量 Menu. CATEGORY _ 
ALTERNATIVE 定义 。 

如 果 要 将 定义 好 的 菜单 资源 加 载 到 Activity 中 ,需要 使 用 Menulnflater. inflate() 方 
法 ,在 下 面 的 章节 中 将 介绍 每 种 菜单 的 加 载 方式 。 


412 菜单 类 型 


Android SDK 支持 丰富 的 菜单 类 型 ,包括 常规 的 菜单 . 子 菜单 、 上 下 文 菜单 图标 菜 
单 、 二 级 菜单 和 替代 菜单 。 此 外 ,Android 3. 0 推出 了 动作 条 ,可 以 与 菜单 进行 交互 。 
Android 4. 0 已 经 推出 弹出 式 菜单 ,可 以 随时 响应 按钮 单 击 或 任何 其 他 UI 事件。 

Android SDK 提供 的 菜单 有 三 种 基本 类 型 : 选项 菜单 、 上 下 文 菜单 和 弹出 菜单 。 

选项 菜单 是 一 个 Activity 菜单 项 的 主要 集合 ,如 果 在 这 里 加 入 操作 ,将 会 影响 应 用 程 
序 的 全 局 。 如 果 使 用 Android 2. 3 或 者 之 前 的 SDK 版 本 开发 ,用 户 可 以 使 用 菜单 键 打开 
选项 菜单 ,但 是 对 于 Android 3. 0 或 者 更 高 的 版 本 来 说 ,选项 菜单 中 的 菜单 项 目 是 通过 动 
作 条 与 其 他 屏幕 动作 项 目 一 起 展现 的 。 从 Android 3. 0 开始 ,一 些 设备 已 经 不 支持 菜单 
键 ,需要 使 用 动作 条 来 开发 应 用 。 

上 下 文 菜单 是 当 用 户 长 按 某 个 视图 或 视图 元 素 后 出 现 的 浮动 菜单 ,菜单 中 包含 的 动 
作 是 与 用 户 所 选择 视图 元 素 相关 的 。 在 Android 3. 0 和 更 高 版 本 上 进行 开发 ,可 以 在 选 
定 的 内 容 上 使 用 上 下 文 操作 模式 ,显示 相应 的 操作 。 这 种 模式 在 屏幕 上 方 的 操作 条 中 显 
示 影 响 所 选 的 内 容 的 操作 项 ,并 允许 用 户 选择 多 个 项 目 。 

弹出 菜单 被 固定 在 调用 菜单 的 视图 元 素 上 ,并 且 在 一 个 垂直 列表 中 显示 菜单 项 目 。 
在 Android 中 ,这 些 菜 单 都 可 以 在 XML 资源 文件 中 定义 ,并 通过 菜单 资源 文件 中 的 ID 
加 载 到 Java 程序 中 。 

下 面 分 别 介绍 这 三 种 类 型 的 菜单 。 

1. 选项 菜单 

在 Android SDK 中 ,由 于 每 个 Activity 都 会 关联 一 个 菜单 ,因此 不 需要 从 头 开始 创 
建 一 个 菜单 对 象 。Android 的 菜单 创建 ,具体 是 由 Activity 的 onCreateOptionsMenu() 回 
调 方 法 来 实现 的 ,选项 菜单 的 创建 也 可 以 由 这 个 回调 方法 来 实现 。 

选项 菜单 中 包含 的 动作 和 选项 与 当前 Activity 上 下 文 相关 ,并 且 根 据 Android 系统 
版 本 的 不 同 ,其 显示 的 位 置 也 不 同 。 如 果 使 用 Android 2. 3. x( API level 10) 或 者 更 低 的 
版 本 , 当 用 户 按 菜单 键 时 ,选项 菜单 的 内 容 显示 在 屏幕 的 底部 ,可 以 最 多 显示 6 个 带 有 图 
标 按钮 的 无 滚动 条 窗 体 ;如 果菜 单项 超过 6 个 就 需要 使 用 扩展 菜单 项 ,这样 这 个 窗 体 的 最 
后 一 个 按钮 变 成 了 More, 选 中 后 会 弹出 一 个 包含 多 个 菜单 项 的 列表 ,可 能 还 带 有 滚动 条 。 
图 4.1 中 的 示例 显示 了 Android 2. 3. x 的 选项 菜单 样式 。 
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图 4.1 Android 2.3.x 选 项 菜单 样式 


如 果 使 用 Android 3. 0(API level 11) 或 者 更 高 的 版 本 ,用 户 可 以 在 动作 条 中 使 用 选 
项 菜单 的 菜单 项 。 默 认 情况 下 ,系统 将 所 有 的 
菜单 项 作为 动作 条 的 溢出 操作 ,用 户 可 以 单 击 
动作 条 最 右边 的 溢出 操作 图 标 显示 没有 显示 
的 菜单 项 ;如 果 手 机 有 菜单 键 ,对 于 不 在 动作 
条 中 显示 的 菜单 项 ,用 户 按 菜单 键 则 会 看 到 剩 
余 的 菜单 项 。 图 4.2 示例 显示 了 Android 3. 0 
的 选项 菜单 样式 。 图 4.2 Android 3.0 的 选项 菜单 样式 

选项 菜单 的 菜单 项 既 可 以 在 Activity 中 
声明 ,也 可 以 在 另 一 种 更 灵活 的 图 形 组件 Fragment 中 声明 。 如 果 Activity 和 Fragment 
都 为 选项 菜单 声明 了 菜单 项 ,而 且 合 并 在 UI 界面 中 ,那么 Activity 中 的 菜单 项 优先 显 
示 , 然 后 才 按 顺序 把 Fragment 中 菜单 项 添加 到 Activity 中 。 如 果 要 设 定 菜单 项 的 顺序 ， 
也 可 以 在 过 item 记 元 素 中 添加 android:orderInCategory 的 属性 ,重新 按 次 序 添加 菜单 项 。 

在 Activity 中 ,通过 覆 羔 其 onCreateOptionMenu() 方 法 来 指定 选项 菜单 ,具体 实现 
加 载 菜 单 ;在 Fragment 中 ,也 是 覆盖 其 onCreateOptionMenu() 方 法 ,通过 菜单 资源 中 定 
义 的 菜单 人 ,获取 菜单 对 象 ,赋值 给 声明 的 菜单 类 变量 ( 见 代 码 4. 4) 。 

代码 4.4 在 onCreateOptionsMenu() 方 法 中 获取 菜单 对 象 





@override 

public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater (); 
inflater.inflate (R.menu.game menu, menu); 
return true; 


) 


在 代码 4.4 中 ,getMenuInflater() 方 法 返回 了 一 个 Menulnflater 对 象 , 用 此 对 象 来 调用 
inflate() 方 法 ,将 菜单 资源 填充 到 菜单 对 象 中 。 一 旦 菜单 项 被 加 载 ,onCreateOptionsMenu() 
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方法 应 该 返回 true, 使 菜单 可 见 。 如 果 此 方法 返回 false ,菜单 是 不 可 见 的 。 对 于 Android 
2.3. x 和 更 低 的 版 本 来 说 ,这 个 方法 是 在 用 户 第 一 次 打开 菜单 的 时 候 由 系统 执行 的 ;而 对 
于 Android 3. 0 和 更 高 的 版 本 来 说 ,由 于 要 在 动作 条 中 显示 菜单 项 ,系统 在 启动 Activity 
时 就 调用 此 方法 。 

在 Android 应 用 程序 中 ,也 可 以 使 用 Menu 类 提供 的 add() 方 法 动态 增加 菜单 项 。 
Menu 类 的 add() 方 法 的 参数 说 明 如 下 : 

。 int groupId: 分 组 标识 ,其 值 相同 的 菜单 项 可 以 归 为 一 组 。 

。 intitemld; 菜单 项 ID, 代 表 菜 单项 的 唯一 编号 ,使 用 这 个 编号 可 以 找到 对 应 的 菜 
单项 。 
int order: 菜单 项 排列 顺序 (代表 的 是 菜单 项 显示 顺序 ,默认 值 是 0) ,其 值 越 小 表 
示 越 重要 , 优先 显示 。 

。 CharSequence title: String 类 型 的 菜单 项 标题 ,表示 需要 在 界面 选项 中 显示 的 文 

字 。 除 了 使 用 字符 串 ,还 可 以 使 用 一 个 字符 串 资 源 , 通 过 R.java 文件 常量 文件 。 

分 组 ID 菜单 项 ID 和 排列 属性 都 是 可 选 的 ,如 果 不 想 特 别 指定 的 话 可 以 使 用 Menu. 
NONE。 代 码 4.5 给 出 了 一 个 简单 的 例子 ,示例 了 如 何 使 用 add() 方 法 动态 加 载 三 个 菜 
单项 。 

代码 4.5 使 用 add() 方 法 动态 加 载 菜单 


@override 
public boolean onCreateOptionsMenu (Menu menu) ( 
//call the base class to include system menus 
super.onCreateOptionsMenu (menu) ; 
menu.add(0 //Group 
,l //item id 
,0 //order 
,"append"); //title 
menu.add(0,2,1,"item2"); 
menu.add(0,3,2,"clear"); 


return true; 


) 


对 于 菜单 选项 的 单 击 事件 ,Android 系统 使 用 专门 的 方法 来 进行 处 理 。 当 用 户 单 击 
菜单 项 时 ,系统 会 调用 Activity 的 onOptionsItemSelected() 方 法 ,并 且 将 用 户 单 击 的 菜单 
项 对 象 (MenuItem) 传 递 给 该 方法 。 在 这 个 方法 中 ,可 以 用 getItemId() 方 法 来 获取 菜单 
项 的 资源 ID ,针对 不 同 的 菜单 项 ,进行 不 同 的 操作 。 代 码 4.6 中 ,通过 getItemId() 获 取 
菜单 ID 后 ,通过 判断 ID 不 同 的 值 , 实 现在 用 户 单 击 菜单 项 后 ,指定 的 文本 框 中 显示 出 所 
单 击 的 菜单 选项 标题 。 当 然 ,这 个 例子 为 了 简单 ,编写 的 事件 响应 操作 代码 都 相同 ,但 实 
际 应 用 程序 中 ,对 应 于 每 个 菜单 选项 的 事件 处 理 ,都 对 应 了 其 响应 的 功能 实现 代码 或 
方法 。 





第 4 章 ”菜单 和 动作 条 NG 
m 





代码 4.6 使 用 onOptionsItemSelected() 方 法 处 理 菜 单项 事件 


QOverride 
public boolean onOptionsItemSelected (MenuItem item) { 
TextView txt= (TextView) findViewById(R.id.txt); 
switch (item.getItemId ()) { 
case 1: 
txt.setText ("you clicked on item "+item.getTitle()); 
return true; 
case 2: 
txt.setText ("you clicked on item "+item.getTitle()); 
return true; 
case 3: 
txt.setText ("you clicked on item "+item.getTitle()); 
return true; 


) 
return super.onOptionsItemSelected(item); 


) 


如 果 被 选 的 菜单 项 得 到 成 功 处 理 , 则 onOptionsItemSelected() 返 回 true 值 ,否则 , 需 
要 调用 父 类 的 onOptionsItemSelected() 方 法 继续 处 理 。 如 果 Activity 中 包含 Fragment, 
那么 系统 首先 会 调用 Activity 中 onOptionsItemSelected() 方 法 ,然后 才 是 每 个 Fragment 
中 的 方法 onOptionsItemSelected ( ), 直到 有 一 个 方法 返回 true 值 , 否则 所 有 的 
onOptionsItemSelected() 方 法 都 会 被 调用 了 。 

除了 使 用 onOptionsItemSelected() 之 外 ,还 可 以 使 用 监听 器 来 响应 和 处 理事 件 ,这 
种 方式 需要 实现 OnMenultemClickListner 接口 以 及 其 onMenultemClick() 方 法 ( 见 代 
码 4.7)。 

代码 4.7 定义 OnMenuItemClickListner 监听 器 


public class MYResponse implements OnMenuClickListener { 


@override 
boolean onMenuItemClick (MenuItem item) { 
//coding 


return true; 


} 


与 传统 的 Java 事件 处 理 程序 类 似 ,Android 应 用 程序 在 使 用 监听 器 处 理事 件 时 ,也 
需要 对 监听 器 进行 注册 。 对 于 代码 4. 7 定义 的 监听 器 ,可 以 使 用 下 面 的 代码 注册 : 


MyResponse myResponse=new MYResponse (…) ; 
menuItem.setOnMenuItemClickListener (myResponse); 
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如 果 同 时 定义 了 onOptionsItemSelected() 方 法 和 监听 器 处 理 方法 , 单 击 菜单 项 就 会 
首先 执行 监听 器 中 的 onMenuItemClick() 方 法 。 如 果 onMenuItemClick() 方 法 返回 值 为 
true, 则 表示 单 击 菜单 项 的 事件 处 理 已 经 完成 ,就 不 会 执行 onOptionsItemSelected() 方 
法 ;如 果 返 回 值 为 false, 才 执行 onOptionsItemSelected() 方 法 。 另 外 ,在 菜单 资源 文件 中 
Android 系统 还 为 菜单 项 提供 了 android:onClick 属性 ,可 以 定义 菜单 项 处 理 单 击 事件 的 
方法 

如 果 多 个 Activity 都 拥有 相同 的 菜单 ,可 以 定义 一 个 只 有 onCreateOptionsMenu() 
和 onOptionsItemSelected() 方 法 的 Activity, 在 其 中 实现 这 个 菜单 ,然后 让 其 他 类 来 继承 
该 类 。 如 果 想 在 子 类 中 添加 新 的 菜单 项 , 则 只 需 重 写 onCreateOptionsMenu() 方 法 ,并 且 
调用 super. onCreateOptionsMenu() 方 法 创建 父 类 的 菜单 项 ,然后 再 使 用 add() 方 法 添加 
新 的 菜单 项 。 

但 是 onCreateOptionsMenu() 方 法 是 用 来 初始 化 菜单 的 状态 ,只 能 在 菜单 刚 被 创建 
时 才 会 执行 ,所 以 不 能 用 这 个 方法 而 在 Activity 的 生命 周期 中 修改 菜单 。 如 果 要 想 动态 
改变 选项 菜单 ,就 要 实现 onPrepareOptionsMenu() 方 法 ,系统 会 将 当前 使 用 菜单 对 象 传 
递 给 该 方法 ,可 以 在 这 个 方法 中 修改 菜单 。Android 2. 3 或 更 低 的 版 本 中 ,系统 会 在 每 次 
菜单 打开 的 时 候 调 用 一 次 onPrepareOptionsMenu( ) 方 法 ;而 在 Android 3. 0 及 以 上 版 
本 ,由 于 选项 菜单 是 在 动作 条 中 显示 的 ,此 选项 菜单 总 是 打开 的 ,因此 必须 调用 
invalidateOptionsMenu() 方 法 请 求 系统 调用 onPrepareOptionsMenu ( ) 方 法 执行 更 新 
操作 。 

下 面 我 们 使 用 一 个 简单 的 例子 ,来 说 明 在 应 用 程序 中 如 何 实 现 选项 菜单 。 从 初始 状 
态 到 完成 菜单 事件 处 理 , 分 为 七 个 步骤 ,下 面 进行 具体 介绍 。 

(1) 新 建 一 个 Activity, fE Android 项 目 中 新 建 一 个 Activity. 

(2) 创建 资源 文件 夹 。 在 Android 项 目的 /res 目录 下 ,使 用 Eclipse 的 File—New—> 
Folder 创建 一 个 新 文件 夹 ,命名 为 menu, 作 为 菜单 资源 文件 存储 的 目录 。 如 果 这 个 目录 
已 经 存在 ,就 使 用 已 存在 的 目录 。 

G) 创建 菜单 XML 文件 。 在 menu 目录 下 ,使 用 与 创建 布局 文件 类 似 的 步骤 ,创建 
菜单 XML 文件 ,命名 为 my_options_menu. xml, 根 节点 元 素 为 二 menu 二 >。 文件 的 内 容 
如 下 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
</menu> 


(4) 添加 Menu Items。 使 用 一 item 二 子 元 素 ,在 my_options_menu. xml 中 添加 所 需 
的 菜单 选项 。 代 码 如 下 : 


<item android:id="@+id/about" 
android:title="About" /> 
<item android:id="@+id/help" 
android:title="Help" /> 


(5) 创建 Menu Items 的 图 标 。 如 果菜 单 选项 需要 设 定 图 标 ,可 以 把 要 使 用 的 图 标 用 
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PNG 文件 格式 存放 在 应 用 程序 的 drawable 目录 下 。 默 认 情 况 下 Eclipse 在 drawable F 
创建 了 1low、medium、 和 high 三 个 子 文件 夹 ,图 标 文件 可 以 放 在 任意 文件 夹 中 。 
图 标的 指定 使 用 item 的 icon 属性 ,具体 语法 见 下 面 代 码 : 


<itemandroid:id="@+id/about" 
android:icon="@drawable/about" 
android:title="About" /> 
<itemandroid:id="@+id/help" 
android:icon="@drawable/help" 
android:title="Help" /> 


(6) 获取 菜单 资源 。 菜 单 资源 文件 定义 完成 后 ,要 显示 在 用 户 界面 上 ,需要 Activity 
加 载 定 义 好 的 菜单 ,在 其 onCreateOptionsMenu() 方 法 中 通过 菜单 资源 文件 名 ,将 定义 好 
的 菜单 实例 化 ,获取 并 加 载 这 个 菜单 对 象 。 下 面 的 代码 是 典型 的 菜单 资源 获取 方法 。 


public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater (); 
inflater.inflate(R.menu.my options menu, menu); 
return true; 


} 


CT) 响应 Item 选择 事件 。 菜 单 加 载 后 ,需要 完成 的 就 是 菜单 选项 的 处 理 了 。 最 简单 
的 方法 就 是 使 用 Activity 提供 的 onOptionsItemSelected() 方 法 。 代 码 如 下 : 


public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) { 
case R.id.about: 
startActivity (new Intent (this, About.class)); 
return true; 
case R.id.help: 
startActivity (new Intent (this, Help.class)); 
return true; 
default: 
return super.onOptionsItemSelected (item); 
y 
) 


到 此 为 止 ,菜单 的 建立 就 完成 了 。 在 菜单 的 具体 实现 过 程 中 ,并 不 是 每 一 个 步骤 都 需 
要 完成 ,可 以 根据 具体 的 情况 省 略 。 

2. 上 下 文 菜单 

在 桌面 系统 的 用 户 界面 中 , 当 用 户 使 用 鼠标 右 击 界面 视图 元 素 时 ,桌面 系统 就 会 弹出 
与 此 视图 元 素 相关 的 动作 列表 。 这 个 功能 非常 方便 ,用 户 可 以 很 容易 地 找到 与 视图 元 素 
相关 的 功能 。 提 供 这 种 功能 的 菜单 , 称 为 上 下 文 菜单 。 


Sm/ 
”we 
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Android 系统 也 支持 相同 的 设计 模式 ,但 由 于 用 户 交互 的 设备 不 同 ,操作 时 界面 的 响 
应 有 所 不 同 。Android 的 上 下 文 菜单 可 以 通过 触摸 屏 操作 调 出 。 当 用 户 按 住 触摸 屏 上 的 
视图 元 素 保持 一 段 时 间 ,就 可 以 调 出 相关 动作 列表 的 上 下 文 菜单 。Android 系统 可 以 为 
任何 视图 提供 上 下 文 菜单 ,但 是 通常 在 ListView, GridView 中 的 项 目 上 使 用 ,或 者 在 其 
他 视图 集合 中 的 项 目 上 使 用 。 

Android 系统 定义 了 两 种 模式 的 上 下 文 菜单 : 

(1) 浮动 模式 。 如 果 用 户 在 视图 元 素 上 执行 一 个 长 单 击 ( 按 住 并 保持 ) 事 件 ,上 下 文 
菜单 项 浮动 列表 会 弹出 ,类似 对 话 框 , 显 示 在 原 有 视图 的 上 面 ,覆盖 原 有 的 部 分 用 户 界面 
WA 4.3 左 图 )。 用 户 可 以 每 次 在 浮动 菜单 中 选择 一 个 可 执行 的 动作 。 

(2) 动作 模式 。 这 种 模式 是 ActionMode 的 系统 实现 ,可 以 在 屏幕 项 部 显示 上 下 文 动 
作 条 动作 条 ,其 中 的 菜单 项 是 影响 所 选 视图 元 素 的 动作 。 当 这 种 模式 被 激活 ,用 户 可 以 在 
使 用 上 下 文 菜单 的 动作 条 中 选择 一 个 或 多 个 动作 。 但 是 ,这 种 模式 只 有 在 Android 3. 0 
或 者 更 高 版 本 的 可 用 ,是 使 用 上 下 文 菜单 的 推荐 模式 。 

















Richard III 


Merchant of Venice 





4.3 菜单 模式 


上 下 文 菜单 的 加 载 与 选项 菜单 类 似 , 都 是 在 Activity 中 通过 特定 方法 中 创建 和 加 载 ， 
但 具体 在 onCreateContextMenu() 方 法 中 实现 ,而 不 是 在 onCreateOptionsMenu( ) 方 法 
中 实现 。 在 实现 onCreateContextMenu() 方 法 时 ,上 下 文 菜单 所 依赖 的 视图 元 素 通过 参 
数 指定 。 

上 下 文 菜单 的 加 载 与 选项 菜单 在 加 载 时 有 所 不 同 。onCreateOptionsMenu() 方 法 在 
每 个 Activity( 或 者 Fragment) 启 动 时 自动 调用 。 由 于 不 是 界面 上 的 所 有 视图 元 素 都 需要 
上 下 文 视图 元 素 ,只 有 通过 registerForContextMenu(view) 方 法 注册 的 视图 元 素 , 才 有 可 
能 创建 对 应 的 上 下 文 菜单 ,因此 只 有 用 户 长 单 击 某 个 视图 元 素 后 才 需 要 执行 
onCreateContextMenu() 方 法 。 

下 面 我 们 使 用 一 个 简单 的 例子 ,来 说 明 一 下 在 应 用 程序 中 如 何 实 现 上 下 文 菜单 。 具 
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体 创 建 步骤 的 前 五 步 与 选项 菜单 相同 ,从 第 六 步 开 始 有 所 不 同 。 有 具体 描述 如 下 。 

(1) 新 建 一 个 Activity Class, 

(2) 创建 资源 文件 夹 。 

(3) 创建 Menu XML 文件 。 

(4) 添加 Menu Items。 

(5) 创建 Menu Items 的 图 标 。 

(6) 注册 视图 元 素 。 

通过 调用 resisterForContextMenu ( ) 方 法 为 视图 元 素 注册 上 下 文 菜 单 。 如 果 
Activity 使 用 了 ListView 或 者 GridView, 且 想 要 其 中 的 每 个 项 目 都 提供 一 个 相同 的 上 下 
文 菜单 ,那么 需要 将 ListView 或 者 GridView 对 象 传递 到 registerForContextMenu() 方 
法 中 。 

(7) 获取 菜单 资源 。 

在 Activity( 或 者 Fragment) 实 现 onCreateContextMenu() 方 法 。 被 注册 视图 元 素 接 
收 到 一 个 长 单 击 事件 ,那么 系统 将 会 调用 这 个 方法 ,在 这 里 可 以 创建 上 下 文 菜单 (代码 4. 8) 。 

代码 4.8 覆盖 onCreateContextMenu() 方 法 


@override 
public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) { 
super.onCreateContextMenu (menu, v, menuInfo); 
MenuInflater inflater=getMenuInflater (); 
inflater.inflate(R.menu.context menu, menu); 


} 


Menulnflater 对 象 允许 使 用 菜单 资源 填充 上 下 文 菜单 对 象 。onCreateContextMenu() 
方法 的 参数 包含 了 用 户 选 择 的 视图 元 素 v 和 提供 关于 被 选项 额外 信息 的 menuInfo 对 
象 。 如 果 需 要 为 Activtiy 中 若干 个 视图 元 素 提供 不 同 的 上 下 文 菜单 ,需要 使 用 这 些 参数 
来 确定 要 填充 的 上 下 文 菜单 。 

对 于 上 下 文 菜单 选项 的 单 击 事件 ,Android 系统 使 用 onContextItemSelected() 方 法 来 进 
行 处 理 。 当 用 户 单 击 上 下 文 菜 单项 时 ,系统 会 调用 Activity 的 onContextItemSelected ( ) 
方法 ,并 且 将 用 户 单 击 的 菜单 项 对 象 (MenuItem) 传 递 给 该 方法 。 

响应 Item 选择 事件 ,覆盖 onContextItemSelected () 方 法 。 具 体 实 现时 ,可 以 用 
getItemId() 方 法 来 获取 菜单 项 的 资源 ID, 针 对 不 同 的 菜单 项 ,编写 不 同 的 代码 实现 其 功 
能 ( 见 代码 4.9) 。 

代码 4.9 使 用 onContextItemSelected() 方 法 处 理 菜 单项 事件 


public boolean onContextItemSelected(MenuItem item) { 
AdapterContextMenuInfo info= (AdapterContextMenuInfo) item.getMenuInfo(); 
Switch (item.getItemId()) { 
caseR.id.edit: 


sa 
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editNote (info.id); 
return true; 
case R.id.delete: 
deleteNote (info.id); 
return true; 
default: 


return super.onContextItemSelected (item); 
) 


如 果 被 选 的 菜单 项 得 到 成 功 处 理 , 则 onContextItemSelected() 返 回 true 值 ,否则 , 需 
要 调用 父 类 的 onContextItemSelected( ) 方 法 继续 处 理 。 与 选项 菜单 类 似 , 如果 Activity 
中 包含 Fragment, 那 么 Activity 将 首先 执行 自己 的 这 个 方法 ,如 果 返 回 值 为 false, 则 通过 
调用 super. onContextItemSelected (item ) 方 法, 单 击 事件 将 会 在 每 个 Fragment 中 的 
onContextItemSelected() 方 法 中 传递 ,按照 Fragment 被 添加 的 顺序 一 个 接着 一 个 ,直到 
返回 true 或 者 全 部 执行 完 为 止 。 

3. 弹出 菜单 

弹出 菜单 是 在 API 级 别 11 和 更 高 版 本 上 才 有 效 的 。 弹 出 菜单 是 一 个 在 视图 元 素 上 
弹出 的 模式 菜单 。 如 果 这 个 视图 元 素 下 方 有 空间 ,那么 弹出 菜单 将 显示 在 视图 元 素 的 下 
方 ,否则 会 显示 在 上 方 。 弹 出 菜单 与 上 下 文 菜单 不 同 , 上 下 文 菜单 是 对 选择 内 容 有 影响 的 


操作 。 
弹出 菜单 的 功能 包括 : 
。 为 关联 到 特殊 内 容 的 动作 提供 一 个 溢出 模式 的 菜 
单 。 例 如 Gmail 的 邮件 头 部 ( 见 图 4. 4)。 | Reply all 


。 提供 一 个 命令 的 第 二 部 分 。 例 如 一 个 标记 为 Add Emaan 
的 按钮 ,使 用 不 同 Add 选项 可 产生 一 个 弹出 菜单 。 

。 提供 一 个 类 似 Spinner 的 下 拉 菜 单 。 图 4.4 Gmail 的 邮件 头 部 

创建 弹出 式 菜单 的 步 双 与 前 两 种 菜单 类 似 。 具 体 创 建 
过 程 中 ,前 五 步 与 前 两 种 菜单 相同 ,从 第 六 步 开始 有 所 不 同 。 

假设 已 经 定义 了 菜单 资源 文件 popup_color_menu. xml( 见 代码 4. 10) 和 用 户 界 面 布 
局 文件 popmenudemo. xml( 见 代码 4. 11) , 则 显示 出 弹出 菜单 还 需要 以 下 几 步 。 

代码 4. 10 ”弹出 菜单 资源 文件 定义 





<?xml version="1.0" encoding="utf-8"?> 

<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/menu red" android:title="Red" /> 
<item android:id="@+id/menu green" android:title="Green"/> 
<item android:id="@+id/menu blue" android:title="Blue"/> 

</menu> 
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代码 4.11 用 户 界 面 布局 文件 





(1) 创建 PopupMenu 对 象 。 

在 所 依附 的 视图 元 素 的 Activity 初始 化 时 ,使 用 PopupMenu 的 构造 方法 实例 化 一 个 
弹出 菜单 对 象 ,并 说 明 当 前 应 用 的 Context 和 所 依附 的 视图 元 素 。 

这 里 把 实例 化 后 的 按钮 和 当前 的 Activity 作为 创建 PopupMenu 时 的 参数 。 


(2) 获取 菜单 资源 ,并 导入 到 popmenu 对 象 。 
可 以 调用 PopupMenu. getMenu() 来 返回 菜单 对 象 。 在 API 14 及 高 于 14 的 ,也 可 
以 用 PopupMenu. inflate() 来 导入 。 





(3) 调用 PopupMenu. show() 。 
在 按钮 单 击 事件 处 理 的 onClicklistener 中 调用 PopupMenu. show() 方 法 ,显示 预定 
义 的 弹出 菜单 。 





(4) 菜单 选项 事件 处 理 。 
对 弹出 菜单 选项 的 事件 处 理 时 ,必须 实现 PopupMenu. OnMenultemClickListener 接 
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口 并 且 通 过 调用 setOnMenultemClickListener() 方 法 把 它 注册 给 PopupMenu 对 象 。 当 
用 户 选 择 某 个 菜单 选项 时 ,系统 会 调用 此 接口 中 的 onMenultemClick O 回调 方法 进行 
处 理 。 

在 此 例 中 ,直接 通过 匿名 内 部 类 的 方式 ,实现 了 PopupMenu. OnMenultemClickListener 
接口 ,并 在 其 onMenuItemClick() 方 法 中 根据 用 户 的 选择 改变 背景 的 颜色 ,然后 使 其 注册 
到 按钮 上 。 具 体 的 代码 实现 和 此 例 完整 的 程序 见 代 码 4. 12。 

代码 4.12 创建 弹出 菜单 
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return true; 


)); 


413 菜单 分 组 


菜单 组 是 菜单 项 集合 ,可 以 用 来 为 菜单 项 设置 共同 的 属性 。 菜 单 组 的 设置 可 以 使 一 
组 菜单 选项 的 属性 同时 改变 ,呈现 出 共同 的 特性 。 例 如 : 

。 使 用 setGroupVisible() 显 示 或 隐藏 组 内 所 有 选项 。 

。 使 用 setGroupEnabled() 启 用 或 禁止 组 内 所 有 选项 。 

。 使 用 setGroupCheckable() 说 明 组 内 所 有 的 选项 是 否 可 选 。 

菜单 组 可 以 在 菜单 资源 文件 中 定义 ,把 一 item 之 元素 其 套 进 天 group 之 元素 中 来 创建 
分 组 菜单 ;或 者 在 Android 应 用 程序 中 ,使 用 带 有 分 组 ID 的 add() 方 法 创建 分 组 。 代 
码 4. 13 是 一 个 在 菜单 资源 文件 中 定义 分 组 的 简单 例子 。 

代码 4. 13 ”菜单 分 组 定义 


<?xml?version="1.0"?encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/menu_save" 
android:icon="@drawable/menu save" 
android:title="@string/menu save" /> 
<!--menu group--> 
<group android:id="@+id/group delete"> 
<item android:id="@+id/menu archive" 
android:title="@ string/menu archive" /> 
<item android:id="@+id/menu delete" 
android:title="@ string/menu delete" /> 
</group> 
</menu> 


在 代码 4. 13 中 ,分 组 菜单 中 的 两 个 菜单 项 与 第 一 个 菜单 项 显示 在 同一 个 层次 级 别 
上 ,看 上 去 没有 什么 区 别 。 但 是 ,能 够 使 用 Android API 中 的 方法 ,通过 引用 分 组 ID 同时 
修改 其 中 两 个 菜单 项 的 属性 ,而 且 系统 不 会 将 分 组 的 菜单 项 给 分 开 。 

菜单 组 还 可 以 用 来 显示 应 用 程序 中 的 选项 开关 ,设置 单 选 和 多 选 两 种 方式 , 单 选 模式 
菜单 见 图 4.5. 

但 是 ,如 果菜 单 组 中 的 菜单 选项 是 图 标 类 型 , 则 不 能 显示 成 复 选 框 或 单 选 按钮 。 如 果 
选择 了 让 图 标 菜单 中 的 菜单 项 可 复 选 ,就 必须 在 每 次 状态 改变 时 通过 手动 更 换 图 标 与 文 
本 来 指明 复 选 的 状态 。 
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4.5 单 选 模式 菜单 


菜单 资源 文件 中 ,一 item 二 元素 中 的 android: checkable 属性 用 于 给 单独 的 菜单 项 定 
义 是 否 可 选 ,一 group 二 元 素 中 的 android: checkableBehavior 属性 用 于 给 一 组 菜单 项 定义 
可 选 类 型 ( 见 代码 4. 14) 。 

代码 4.14 为 菜单 项 设置 单 选 按 钮 


<?xml?version="1.0"?encoding="utf-8"?> 
<menu?xmlns:android="http://schemas.android.com/apk/res/android"> 
<group?android:checkableBehavior="single"> 
<item?android:id="@+id/red" 
android:title="@string/red"?/> 
<item?android:id="@+id/blue" 
android:title="@string/blue"?/> 
</group> 
</menu> 


一 group 二 元 素 的 android: checkableBehavior 属性 可 以 有 以 下 三 种 设置 : single 代表 
菜单 组 中 仅 有 一 项 能 够 被 选 ( 单 选 按钮 ) ;all 代表 所 有 菜单 项 都 能 够 被 选 ( 复 选 框 ) ;none 
代表 没有 项 目 是 可 复 选 的 。 在 二 item 放 元 素 中 可 以 使 用 android: checked 属性 给 菜单 项 
设置 默认 的 选择 状态 ,也 可 以 用 setChecked() 方 法 在 代码 中 改变 。 

当 一 个 可 复 选 的 菜单 项 被 选择 的 时 候 , 系 统 会 调用 对 应 被 选择 的 菜单 项 的 回调 方法 
(如 onOptionsItemSelected())。 由 于 复 选 框 或 复 选 按钮 不 会 自动 地 改变 它们 的 状态 , 因 
此 必须 在 这 个 方法 中 重新 设置 复 选 框 的 状态 。 一 般 使 用 isChecked() 方 法 来 查询 复 选 菜 
单 的 当前 状态 (被 用 户 选择 之 前 的 状态 ) ,然后 用 setChecked() 方 法 设置 选择 状态 ( 见 代 
码 4.15)。 
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代码 4.15 ”在 事件 处 理 方法 中 设置 菜单 项 的 选择 状态 


@override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.vibrate: 
case R.id.dont_vibrate: 
if (item.isChecked()) item.setChecked(false); 
else item.setChecked (true); 
return true; 
default: 
return super.onOptionsItemSelected (item); 


) 


如 果 不 用 这 种 方式 设置 复 选 状态 ,那么 当 用 户 选择 菜单 项 ( 复 选 框 ) 的 时 候 , 它 的 可 视 
状态 将 不 会 发 生 改变 。 


4.1.4 设置 Intent 


菜单 选项 也 可 以 创建 Intent 来 启动 另 一 个 Activity, 这 个 Activity 既 可 以 是 本 应 用 
程序 中 的 ,也 可 以 是 其 他 应 用 程序 中 的 。 如 果 确 认 了 所 需 的 Intent 的 特性 以 及 初始 化 此 
Intent 的 菜单 选项 后 ,就 可 以 在 菜单 选项 事件 响应 的 回调 方法 中 使 用 startActivity() 运 
行 此 Intent。 

但 是 添加 调用 这 个 Intent 对 象 的 菜单 项 之 后 ,如 果 不 能 确定 用 户 设备 上 是 否 包 含 了 
处 理 这 个 Intent 对 象 的 应 用 程序 ,就 有 可 能 由 于 没有 接收 这 个 Intent 对 象 的 Activity, 导 
致 这 个 菜单 选项 不 会 有 任何 作用 ,不 能 实现 预期 的 功能 ,成 为 一 个 非 功能 性 菜单 选项 。 这 
个 问题 可 以 使 用 动态 添加 菜单 项 的 方法 来 解决 ,Android 通过 在 设备 上 查找 处 理 Intent 
对 象 的 Activity ,动态 地 把 菜单 项 添加 到 菜单 中 。 

为 了 防止 上 述 问 题 发 生 , 可 以 在 添加 菜单 选项 具体 采取 一 些 措施 ,例如 : 

(1) 使 用 分 类 CATEGORY _ ALTERNATIVE 和 CATEGORY _ SELECTED _ 
ALTERNATIVE 定义 的 Intent。 

(2) 调用 Menu. addIntentOptions() 方 法 ,Android 系统 会 搜索 能 够 接收 这 个 Intent 
对 象 的 应 用 程序 ,将 菜单 选项 添加 到 菜单 中 。 

G) 如 果 没 有 应 用 程序 满足 Intent 的 要 求 ,就 不 添加 菜单 选项 。 

由 于 CATEGORY_SELECTED_ALTERNATIVE 只 用 于 处 理 当 前 屏幕 上 被 选择 的 
元 素 , 因 此 只 在 用 onCreateContextMenu() 方 法 创建 菜单 时 使 用 这 个 分 类 ( 见 代码 4.16). 

代码 4.16 动态 添加 Intent 菜单 选项 


@override 
public boolean onCreateOptionsMenu (Menu menu) { 


super.onCreateOptionsMenu (menu) ; 
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//Create an Intent that describes the requirements to fulfill, to 
be included 

//in our menu. The offering app must include a category value of Intent. 
CATEGORY ALTERNATIVE. 

Intent intent=new Intent (null, dataUri); 

intent.addCategory(Intent.CATEGORY_ALTERNATIVE); 


//Search and populate the menu with acceptable offering applications. 
menu.addIntentOptions( 

R.id.intent group,//Menu group to which new items will be added 

0, //Unique item ID (none) 

0, //Order for the items (none) 

this.getComponentName(), //The current Activity name 

null, //Specific items to place first (none) 

intent, //Intent created above that describes our requirements 

0, //Additional flags to control items (none) 


null); //Array of Menultems that correlate to specific items (none) 


return true; 


} 


每 找到 一 个 Intent Filter 与 所 定义 的 Intent 对 象 相 匹 配 的 Activity, Menu 类 的 
addIntentOptions( ) 方 法 都 会 添加 一 个 菜单 项 ,这 个 菜单 项 使 用 其 Intent Filter 的 
android:label 的 属性 值 作 为 菜单 项 的 标题 ,应 用 程序 的 图 标 作 为 菜单 项 的 图 标 。 
addIntentOptions() 方 法 返回 被 添加 的 菜单 的 个 数 。 


4.2 动作 条 模式 


动作 条 (ActionBar) 是 位 于 Activity 顶端 的 一 个 图 形 控件 ,能 够 显示 Activity 的 标 
题 \ 图 标 \ 可 能 触发 的 动作 、 附 加 视图 和 其 他 交互 控件 ,也 可 以 用 于 在 应 用 程序 中 导航 。 

动作 条 是 用 户 浏览 界面 非常 重要 的 设计 元 素 ,动作 条 主要 提供 以 下 功能 : 

。 支持 应 用 程序 内 的 一 致 导航 和 视图 切换 。 

。 为 极 少 使 用 的 操作 提供 “溢出 动作 ”模式 ,减少 混乱 。 

。 提供 专门 位 置 来 显示 应 用 程序 的 标识 ,提示 用 户 在 当前 应 用 程序 中 的 位 置 。 

。 突出 重要 操作 ,提供 预 访问 模式 。 

对 于 大 多 数 应 用 ,动作 条 可 以 分 割 为 应 用 图 标 、 视 图 控制 、 动 作 按钮 和 溢出 动作 四 个 
不 同 的 功能 区 域 ,分 别 对 应 于 图 4. 6 中 标识 的 “1”“2”“3” 和 “4” 各 区 域 。 


(W Action Bar 1: Q m : 
i B u t 
图 4.6 ActionBar 的 各 区 域 
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1. 应 用 图 标 

应 用 图 标 是 应 用 程序 的 标识 ,需要 的 话 可 以 使 用 不 同 的 logo 或 标牌 。 如 果 当 前 不 是 
应 用 的 顶层 界面 , 则 在 图 标 左边 会 有 一 个 向 左 的 箭头 ,表示 “向 上 ”按钮 ,使 用 户 可 以 回 到 
上 一 级 界面 (图 4.7 中 右 图 的 logo 左边 ) 。 


Us App home 《 ko] Lower leve! 
图 4.7 应 用 图 标 


2. 视图 控制 

如 果 应 用 程序 可 以 在 多 个 不 同 的 视图 中 显示 数据 ,动作 条 的 “视图 控制 ?能 让 用 户 在 
视图 之 间 进 行 切换 。 例 如 ,可 以 在 下 拉 菜单 和 标签 视图 之 间 进 行 切换 。 如 果 应 用 程序 不 
支持 不 同 的 视图 ,也 可 以 使 用 这 个 区 域 显示 非 交 互 内 容 , 例 如 应 用 程序 标题 或 较 长 的 标识 
信息 。 

3. 动作 按钮 

动作 按钮 用 于 显示 应 用 程序 中 最 重要 的 动作 。Andriod 提供 动作 条 的 设计 模式 是 为 
了 方便 用 户 选 择 与 上 下 文 环境 相关 的 最 重要 的 动作 ,那些 直接 显示 在 动作 按钮 区 域 上 的 
图 标 或 者 文本 被 称 为 动作 按钮 。 如 果 动 作 条 的 这 部 分 区 域 不 够 容纳 所 有 的 动作 ,就 自动 
移入 后 面 的 “溢出 动作 ”。 长 单 击 图 标 就 可 以 显示 出 “溢出 动作 ”中 隐藏 的 动作 。 

4. 溢出 动作 

平常 很 少 用 到 的 动作 一 般 被 放 在 这 部 分 区 域 中 。 动 作 按钮 区 域 和 溢出 动作 区 域 中 的 
动作 按钮 可 能 会 根据 屏幕 的 大 小 和 形状 发 生变 化 。 

Android 2. 3 以 及 之 前 的 系统 使 用 设备 上 的 返回 键 实现 一 个 应 用 程序 内 部 的 浏览 ， 
这 就 是 返回 浏览 模式 。 但 是 从 Android 3. 0 版 本 开始 ,Android 设备 使 用 虚拟 浏览 条 , 即 
动作 条 ,代替 了 传统 的 物理 按键 。 从 Android 3. 0 (API level 11) 开 始 , 当 Activity 使 用 系 
统 的 默认 主题 模式 显示 时 ,动作 条 就 出 现在 Activity 窗口 的 顶部 。 当 然 也 可 以 通过 属性 
设 定 动作 条 的 模式 和 增加 动作 条 。 

动作 条 的 API 首先 在 Android 3.0 (API level 11) 系 统 使 用 ,但 是 要 在 Android 2. 1 
CAPI level 7) 的 版 本 中 运行 时 ,也 可 以 导入 相应 的 库 兼 容 支持 。 在 不 同 的 Android 版 本 
中 ,大 多 数 API 都 是 相同 的 ,只 是 所 在 的 包 不 同 。 

如 果 支 持 API level 11 低 的 版 本 ,代码 如 下 : 


import android.support.v7.app.ActionBar 
如 果 支 持 API level 11 高 的 版 本 ,代码 如 下 : 
import android.app.ActionBar 


默认 状态 下 ,动作 条 跟 在 应 用 程序 标题 后 面 ,显示 在 应 用 程序 的 顶部 。 如 果 Activity 
设置 了 弹出 菜单 ,就 可 以 从 动作 条 以 动作 选项 的 方式 直接 访问 。 
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使 用 动作 条 可 以 与 许多 控件 结合 使 用 ,动作 条 支持 的 基本 应 用 模式 如 下 : 
。 动作 选项 Action Item。 

。 动作 视图 Action View, 

。 动作 提供 器 Action Provider, 

。 导航 标签 Navigation Tab, 

下 拉 菜 单 Dropdown Menu, 


4.2.1 添加 Action ltem 


从 Android 3.0(API Level 11) 开 始 ,动作 条 就 被 包含 在 使 用 Theme. Hole 主题 的 
Activity 中 ,或 者 是 这 些 Activity 的 子 类 中 。 由 于 动作 条 只 能 运行 在 Android 3. 0(API 
Level 11) 或 更 高 的 版 本 上 ,动作 条 蔡 代 了 选项 菜单 ,并 且 蔡 换 了 传统 的 应 用 程序 标题 栏 。 
在 添加 Action items 到 动作 条 之 前 ,需要 打开 Manifest 文件 ,确认 用 户 SDK 的 属性 
targetSdkVersion 或 minSdkVersion 属性 被 设置 为 11 或 更 大 的 数值 。 下 面 的 代码 是 一 
个 设置 targetSdkVersion 属性 的 例子 。 


<manifest …> 
<uses-sdk android:minSdkVersion="4" 
android:targetSdkVersion="11" /> 


</manifest> 


在 这 个 例子 中 ,应 用 程序 运行 要 求 的 最 小 API 版 本 是 4(Android 1. 6) ,但 是 目标 
API 版 本 是 11(Android 3. 0) 。 也 就 是 说 在 Android 1. 6 版 本 支持 下 ,应 用 程序 可 以 完成 
基础 重要 的 功能 ,但 当 应 用 程序 运行 在 Android 3. 0 或 更 高 的 版 本 上 时 ,系统 就 会 给 每 个 
Activity 应 用 全 景 主题 ,支持 所 有 设计 的 界面 和 功能 ,包括 动作 条 。 如 果 要 使 用 动作 条 
API 来 进行 添加 导航 模式 和 修改 动作 条 样式 的 操作 ,就 要 把 minSdkVersion 属性 设置 为 
11 或 更 大 的 值 。 

在 查看 API 版 本 的 同时 ,还 需要 确认 下 面 列 出 的 代码 不 存在 ,否则 应 用 程序 运行 时 
动作 条 也 不 会 显示 。 


<application 


android:theme="@android:style/Theme.NoTitleBar" 


若 在 应 用 程序 界面 中 不 需要 动作 条 , 则 把 Activity 的 主题 设置 为 Theme. Holo. 
NoActionBar 就 可 以 了 。 具 体 代码 如 下 : 


<activity android:theme="@android:style/Theme.Holo.NoActionBar"> 


动作 条 的 显示 和 隐藏 也 可 以 在 应 用 程序 运行 中 动态 调整 。 在 Activity 中 使 用 
getActionBar() 获 取 动 作 条 对 象 后 ,使 用 ActionBar 提供 的 hide() 方 法 和 show() 方 法 可 
以 直接 改变 动作 条 的 显示 状态 。 代 码 如 下 。 
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ActionBar actionBar=getActionBar (); 
actionBar.hide () 7 


当 动作 条 隐藏 时 ,系统 会 调整 Activity 的 显示 大 小 ,来 填充 当前 有 效 的 屏幕 空间 。 在 
隐藏 和 删除 动作 条 时 ,为 了 填充 被 动作 条 占用 的 空间 ,可 能 会 导致 Activity 的 重新 布局 。 
如 果 Activity 有 规律 地 隐藏 和 显示 动作 条 ,使 用 覆盖 模式 是 较 好 的 选择 。 设 置 动作 条 覆 
盖 模 式 ,需要 给 Activity 创建 一 个 主题 ,并 且 把 android: windowActionBarOverlay 属性 
设置 为 true。 

默认 情况 下 ,系统 在 动作 条 中 使 用 应 用 的 图 标 , 这 是 通过 一 application 之 和 < 王 activity 之 
元 素 中 的 icon 属性 指定 。 但 是 ,如 果 设置 了 logo 属性 ,动作 条 会 使 用 logo 属性 指定 的 图 
片 资源 ,而 代替 icon 属性 指定 的 资源 。 

由 于 Android 3. 0 及 以 上 版 本 用 动作 条 蔡 代 了 选项 菜单 , 当 Activity 首次 启动 时 , 系 
统 会 调用 onCreateOptionsMenu() 方 法 创建 Action Item 类 型 的 动作 条 ,可 以 在 这 个 方法 
中 获取 定义 好 的 XML 菜单 资源 。 而 且 当 Action Item 的 某 个 选项 被 选中 时 ,对 用 户 操作 
事件 的 获取 和 处 理 ,Android 系统 同样 调用 onOptionsItemSelected() 方 法 来 进行 处 理 。 
因此 动作 条 中 Action Item 的 定义 与 菜单 选项 相同 ,创建 Action Item 类 型 动作 条 和 事件 
处 理 的 过 程 也 基本 与 选项 菜单 的 步骤 一 致 。 

下 面 我 们 用 一 个 简单 的 例子 ,来 说 明 在 应 用 程序 中 如 何 实现 Action Item 的 动作 条 
(具体 代码 见 代码 4. 17)。 假 设 Activity 的 布局 文件 main_activity_actions. xml 已 经 
存在 。 

(1) 确认 Manifest 文件 中 的 设置 。 

(2) 打开 或 创建 一 个 Activity Class。 

(3) 若菜 单 资 源 目 录 /res/menu 不 存在 ,创建 这 个 目录 。 

(4) 创建 Menu XML 文件 。 

在 res/menu 目录 下 创建 菜单 资源 文件 menu_actions. xml, 在 其 中 设置 三 个 菜单 
选项 。 

代码 4.17 动作 条 Action Item 的 定义 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/action search" 
android:icon="@drawable/ic action search" 
android:title="@string/action search"/> 
<item android:id="@+id/action compose" 
android:icon="@drawable/ic action save" 
android:title="@string/action save" /> 
<item android:id="@+id/itemHelp" 
android:icon="@drawable/ic action help" 
android:title="@string/btnHelp" /> 
</menu> 


X 
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1. 设置 显示 动作 选项 

在 XML 文件 中 ,能 够 通过 设置 <item 之 元 素 的 android: showAsAction= "ifRoom" 
属性 ,使 菜单 项 显示 在 动作 条 中 。 菜 单项 首先 作为 动作 按钮 显示 在 动作 条 中 ,如 果 没 有 足 
够 的 空间 ,其 他 菜单 项 会 显示 在 溢出 动作 中 。 

<item>Jú# Í android:showAsAction 有 一 系列 属性 ,下 面 列 出 重要 的 几 个 : 

。 never: 此 菜单 项 不 显示 在 动作 条 中 , 当 单 击 菜单 按钮 时 ,显示 在 列表 中 。 

。 ifRoom: 如 果 动 作 条 有 足够 空间 ,此 菜单 项 显示 在 动作 条 上 。 

。 always: 此 菜单 项 一 直 作为 动作 按钮 显示 ,但 不 推荐 使 用 ,可 能 会 引起 视图 重生 。 

。 withText: 此 菜单 项 使 用 定义 的 文本 模式 显示 。 

如 果菜 单项 使 用 android:title 和 android: icon 属性 同时 设置 了 标题 和 图 标 ,那么 默 
认 情 况 下 ,动作 条 中 动作 项 仅 显 示 图 标 。 如 果 要 显示 文本 标题 ,就 要 给 android: 
showAsAction 属性 添加 withText 设置 ,表示 需要 显示 标题 。 代 码 如 下 : 


android:showAsAction="ifRoom|withText" /> 


一 般 来 说 ,即使 不 需要 在 动作 条 上 显示 文本 标题 ,也 应 该 在 XML 文件 中 给 每 个 菜单 
项 定义 android:title 属性 ,这 是 因为 需要 考虑 下 面 几 种 情况 : 

。 如 果 动 作 条 中 没有 足够 的 空间 来 显示 动作 项 ,菜单 项 就 会 显示 在 溢出 动作 中 ,在 
这 里 只 能 显示 标题 。 

。 若 只 用 图 标 来 显示 动作 项 , 当 用 户 长 单 击 动作 按钮 时 ,可 以 显示 带 有 标题 的 提示 
信息 。 

。 屏幕 阅读 器 可 以 给 有 视觉 障碍 的 用 户 朗读 菜单 项 标题 。 

添加 动作 选项 显示 设置 代码 后 的 菜单 资源 文件 见 代码 4. 18。 

代码 4.18 设置 显示 动作 选项 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/action search" 
android:icon="@drawable/ic action search" 
android:showAsAction="ifRoom|withText" /> 
android:title="@string/action search"/> 
<item android:id="@+id/action compose" 
android:icon="@drawable/ic action save" 
android:showAsAction="ifRoom|withText" /> 
android:title="@string/action save" /> 
<item android:id="@+id/itemHelp" 
android:icon="@drawable/ic action help" 
android:showAsAction="ifRoom|withText" /> 
android:title="@string/btnHelp" /> 
</menu> 


2. 获取 Menu XML 定义 的 动作 选项 资源 
在 Activity 中 ,动作 选项 资源 的 获取 方式 与 选项 菜单 相同 ,都 可 以 从 预定 义 的 菜单 资 
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源 文件 中 加 载 , 在 onCreateOptionsMenu() 方 法 中 实现 创建 动作 选项 。 这 里 ,使 
Menulnflater 类 的 inflate() 方 法 ,从 menu_actions. xml( 见 代码 4. 18) 文 件 中 获取 预定 义 
的 菜单 项 资源 作为 动作 选项 ( 见 代码 4.19). 

代码 4. 19 ”获取 菜单 资源 

















@override 

public boolean onCreateOptionsMenu (Menu menu) { 
//Inflate the menu items for use in the action bar 
MenuInflater inflater=getMenuInflater (); 
inflater.inflate (R.menu.menu_actions, menu); 
return super.onCreateOptionsMenu (menu); 


} 


3. 响应 Action Item 选择 事件 

动作 选项 加 载 后 ,需要 完成 的 就 是 动作 选项 的 事件 处 理 。 与 选项 菜单 相同 ,最 简单 的 
方法 就 是 使 用 Activity 提供 的 onOptionsItemSelected() 方 法 。 当 用 户 选 择 了 一 个 动作 
时 ,系统 会 调用 Activity 的 onOptionsItemSelected() 方 法 ,并 且 传 递 Menultem 对 象 给 这 
个 方法 。 可 以 使 用 getItemId() 方 法 得 到 android:id 属性 为 菜单 项 定义 的 ID, 来 识别 用 
户 单 击 的 动作 ( 见 代码 4.20). 

代码 4. 20 Action Item 事件 处 理 

















@override 
public boolean onOptionsItemSelected(Menultem item) ( 
//Handle presses on the action bar items 
switch (Item.getItemId()) { 
caseR.id.action search: 
Toast .makeText (MainActivity.this, "Search is Selected", Toast. 
LENGTH_SHORT) . show () ; 
return true; 
case R.id.action_save: 
Toast.makeText (MainActivity.this, "Save is Selected", Toast. 
LENGTH_SHORT) . show () ; 
return true; 
case R.id.action help: 
Toast.makeText (MainActivity.this, "Help is Selected", Toast. 
LENGTH_SHORT) . show () ; 
return true; 
default: 


return super.onOptionsItemSelected(item); 
i 


如 果 在 Fragment 中 添加 菜单 项 ,那么 通过 Fragment 类 的 onCreateOptionsMenu [E] 
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调 方法 , 当 用 户 选择 其 中 一 个 Fragment 的 菜单 项 时 ,系统 会 调用 那个 Fragment 对 象 对 
应 的 onOptionsItemSelected() 方 法 。 


4.2.2 添加 Actiion View 


动作 视图 Actiion View 是 作为 动作 按钮 的 替代 品 显示 在 动作 条 中 的 一 个 可 视 构 件 。 
动作 视图 在 不 改变 Activity 或 Fragment 的 情况 下 ， 


| Q 二 可 以 给 用 户 提供 快捷 的 访问 和 丰富 的 操作 。 例 如 ， 
l 如 果 有 一 个 用 于 搜索 的 可 选 菜 单项 国 , 可 以 用 

图 Q, Search the dictionary H Search View 类 来 替代 动作 条 上 的 搜索 按钮 人。 
Bas Enni E 4. 8 A T AA 3J ME t £ TA JE 3F 29 2 f: 38 El 00 


例子 
在 菜单 资源 文件 中 , nf J fE H < item >— 的 android: actionLayout 或 android: 
actionViewClass 属性 来 指定 一 个 布局 资源 或 控件 类 ,从 而 定义 一 个 Action View, fin, 
代码 4. 21 中 指定 了 一 个 SearchView 控件 作为 Action View。 
代码 4.21 在 菜单 资源 中 指定 Action View 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas .android.com/apk/res/android"> 
<item android:id="@+id/menu_search" 
android:title="@string/menu_search" 
android:icon="@drawable/ic_menu_search" 
android:showAsAction="ifRoom|collapseActionView" 
android:actionViewClass="android.widget.SearchView" /> 


</menu> 


android:showAsAction 属性 也 可 包含 collapseActionView 属性 值 ,这 个 值 是 可 选 
的 。 如 果 android:showAsAction 属性 得 值 包含 了 collapseActionView, 说 明 所 声明 的 动 
作 视 图 会 折 秋 到 一 个 按钮 中 , 当 用 户 选择 这 个 按钮 时 再 展开 。 否 则 ,上 默认 状态 下 这 个 动作 
视图 是 可 见 的 ,要 占据 动作 条 的 有 效 空间 。 

如 果 为 某 个 动作 选项 设 定 了 动作 视图 ,由 于 在 用 户 选择 这 个 动作 选项 时 ,系统 会 展开 
对 应 的 动作 视图 ,因此 不 必 在 onOptionsItemSelected() 回 调 方法 中 响应 这 个 动作 选项 ， 
进行 相应 的 事件 处 理 ,而 是 直接 交 给 动作 视图 的 事件 处 理 代码 来 完成 。 但 是 , 如 果 
onOptionsItemSelected() 中 设置 返回 true 值 ,系统 还 是 会 回调 这 个 方法 ,动作 视图 则 不 
会 打开 。 当 用 户 选 择 了 动作 条 中 的 “向 上 ”图 标 或 按 下 了 回 退 按钮 时 ,系统 也 会 把 动作 视 
图 折 秋 起来。 如 果 需 要 ,可 以 在 代码 中 通过 expandActionView() 和 collapseActionView() 
方法 来 展开 或 折 双 动作 视图 。 

动作 视图 的 事件 处 理 代 码 放 在 Activity 的 onCreateOptionsMenu() 方 法 内 , 当 事 件 
发 生 时 系统 回调 此 方法 ,由 注册 的 监听 器 捕获 相应 的 事件 ,执行 事件 处 理 代 码 , 实 现 选择 
动作 视图 后 对 应 的 功能 。 在 onCreateOptionsMenu() 方 法 中 ,通过 调用 带 有 菜单 选项 ID 
的 findItem() 方 法 来 获取 菜单 选项 ,然后 再 调用 getActionView() 方 法 获得 动作 视图 中 的 
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元 素 ( 见 代码 4. 22) 。 
代码 4. 22 ”获得 动作 视图 中 的 元 素 


QOverride 

public boolean onCreateOptionsMenu (Menu menu) { 
getMenuInflater () .inflate (R.menu.main activity actions, menu); 
MenuItem searchItem=menu.findItem(R.id.action search); 
SearchView searchView= (SearchView) MenuItemCompat .getActionView 
(searchItem); 
//Configure the search info and add any event listeners 


return super.onCreateOptionsMenu (menu); 


在 对 动作 视图 操作 时 ,会 有 两 种 情况 : 展开 和 折合。 针对 这 两 种 操作 , Android 
提供 了 OnActionExpandListener 接口 的 onMenultemActionExpand ( ) 方法 和 
onMenultemActionCollapse() 方 法 ,在 事件 发 生 时 进行 回调 。 编 写 事件 处 理 代码 时 ,可 以 
首先 实现 OnActionExpandListener 接口 ,根据 不 同 的 操作 ,分 别 在 对 应 的 方法 中 实现 相 
应 的 功能 。 然 后 创建 一 个 OnActionExpandListener 对 象 , 即 一 个 事件 , 并 使 用 
setOnActionExpandListener() 方 法 来 注册 这 个 事件 。 完 成 这 些 工 作 , 系 统 就 能 够 在 动作 
视图 展开 和 折 倒 时 使 用 相应 的 回调 方法 进行 处 理 了 ( 见 代码 4. 23) 。 

代码 4.23 动作 视图 的 事件 处 理 





@override 
public boolean onCreateOptionsMenu (Menu menu) { 
getMenuInflater().inflate (R.menu.options, menu); 
MenuItem menuItem=menu.findItem(R.id.actionItem); 
//When using the support library, the setOnActionExpandListener () 
method is 
//static and accepts the Menultem object as an argument 
MenuItemCompat.setOnActionExpandListener (menuItem, 
new OnActionExpandListener() { 
@Override 
public boolean onMenuItemActionCollapse (MenuItem item) { 
//Do something when collapsed 


return true; //Return true to collapse action view 


@Override 
public boolean onMenuItemActionExpand (MenuItem item) { 


//Do something when expanded 
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return true; //Return true to expand action view 


423 添加 Action Provider 


与 动作 视图 类 似 , 动 作 提 供 器 Action Provider 使 用 一 个 定制 的 布局 代替 一 个 动作 按 
钮 。 与 动作 视图 不 同 , 当 单 击 动作 提供 器 时 ,其 可 以 显示 子 菜单 ,并 需 对 所 有 选项 进行 控 
制 处 理 。 

有 两 种 方式 来 使 用 Action Provider; 

。 在 应 用 程序 代码 中 ,调用 Menultem 类 提供 的 方法 setActionProvider( ActionProvider) , 

直接 在 菜单 选项 上 设置 动作 提供 器 。 

。 在 菜单 资源 文件 中 声明 动作 提供 器 。 

Android 系统 提供 了 一 些 预 定义 的 Action Provider, 例 如 ,ShareActionProvider 提供 
了 一 个 子 菜单 ,菜单 中 包括 Google+, Hangouts 和 Messaging 等 菜单 选项 ,已 经 实现 了 
其 功能 。 通 过 使 用 这 个 预定 义 的 动作 提供 器 ,可 以 将 这 些 可 能 共享 的 应 用 列表 直接 在 动 
作 条 上 显示 出 来 ,供用 户 使 用 。 使 用 如 果 要 声明 一 个 动作 提供 器 , 需 在 菜单 资源 文件 中 设 
定 所 对 应 的 一 item 二 元 素 的 android:actionProviderClass 属性 ,使 用 所 选 的 预定 义 Action 
Provider 的 完整 类 名 来 指定 动作 提供 器 ( 见 代码 4. 24) 。 如 果 需 要 创建 自己 定义 的 动作 
提供 器 ,也 可 以 通过 继承 Action Provider 类 来 定义 。 

代码 4.24 声明 Action Provider 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:id="@+id/menu_share" 
android:title="@string/share" 
android:showAsAction="ifRoom" 
android:actionProviderClass="android.widget.ShareActionProvider" /> 


</menu> 


由 于 每 一 个 Action Provider 类 定义 自身 的 动作 行为 ,就 不 必 在 onOptionsItemSelected() 
监听 动作 事件 了 。 如 果 需 要 在 onOptionsItemSelected() 方 法 中 对 其 他 的 动作 的 事件 进 
行 处 理 , 必 须 确认 此 方法 的 返回 值 为 false, 从 而 保证 动作 提供 器 上 菜单 选项 的 事件 发 生 
时 系统 能 够 回调 onPerformDefaultAction() 方 法 ,执行 其 事件 处 理 代码 。 

前 面 的 知识 中 提 到 过 ,在 用 户 界面 上 选择 选项 菜单 的 任何 一 个 选项 ,系统 都 会 回调 
onOptionsItemSelected() 方 法 ,而 动作 条 是 Android 高 级 版 本 中 选项 菜单 的 蔡 代 控件 ,所 
以 一 般 情况 下 ,可 以 把 动作 提供 器 的 事件 处 理 也 放 在 onOptionsItemSelected() 方 法 中 ， 
系统 会 在 选择 动作 提供 器 时 回调 这 个 方法 。 
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但 值得 注意 的 是 ,如 果 动 作 提供 器 定义 了 一 个 子 菜单 , 则 在 用 户 打 开 子 菜单 列表 或 选 
择 子 菜单 选项 时 ,Activity 无 法 接收 onOptionsItemSelected() 的 回调 ,事件 处 理 代码 必须 
写 在 onPerformDefaultAction() 方 法 中 。 


4.2.4 使 用 系统 定义 的 Action Provider 


Android 系统 定义 了 一 些 Action Provider, 提供 了 丰富 的 功能 。 每 个 Action 
Provider 类 都 定义 了 自己 布局 (例如 子 菜单 ) 和 动作 行为 ,其 他 的 应 用 程序 在 使 用 这 些 
Action Provider 时 ,可 以 直接 使 用 其 功能 ,由 onPerformDefaultAction() 回 调 方法 中 系统 
定义 的 代码 来 处 理事 件 ,不 需要 再 在 onOptionsItemSelected() 方 法 中 监听 动作 和 进行 事 
件 处 理 。 但 是 ,尽管 预定 义 的 Action Provider 提供 了 其 在 溢出 菜单 中 所 能 执行 的 默认 操 
作 , 应 用 程序 的 Activity( 或 Fragment) 也 能 够 通过 处 
理 来 自 onOptionsItemSelected() 回 调 方法 的 单 击 事 
件 , 来 重 写 这 个 默认 操作 。 

下 面 ,我们 把 系统 预定 义 ActionProvider 之 一 的 
ShareActionProvider 类 作为 例子 ,说 明 如 何 使 用 这 些 
Action Provider。 

ShareActionProvider 类 提供 “共享 ”动作 , 它 负 
责 创建 子 菜单 的 所 有 人 逻辑 ,包括 共享 视图 的 封装 、 
单 击 事件 的 处 理 以 及 溢出 菜单 中 的 选项 显示 等 。 
在 使 用 这 个 类 时 ,所 需要 编写 的 唯一 的 代码 就 是 
给 对 应 的 菜单 项 声明 动作 提供 器 ,并 指定 共享 的 
Intent 对 象 。 如 果 要 在 动作 条 中 提供 一 个 “共享 
动作 ,来 充分 利用 安装 在 设备 上 的 其 他 应 用 程序 ， 
例如 把 一 张 图 片 共享 给 消息 或 社交 应 用 程序 使 
用 , 则 使 用 ShareActionProvider 类 是 一 个 有 效 的 方 
法 , 见 图 4.9。 

要 使 用 ShareActionProvider 实现 共享 动作 ,需要 再 完成 下 面 几 个 工作 : 

(1) 打开 或 创建 Activity Class。 

(2) 定义 菜单 资源 文件 。 

定义 Action Bar 上 的 动作 选项 ,并 在 一 item 二 元 素 下 ,定义 actionProviderClass 属性 
的 值 为 ShareActionProvider 的 完整 类 名 ( 见 代码 4. 24) 。 

(3) 获 取 Action Provider 对 象 。 

在 Activity 中 定义 一 个 ShareActionProvider 类 型 的 私有 变量 mShareActionProvider, 然 
后 在 onCreateOptionsMenu() 方 法 中 ,使 用 getActionProvider() 方 法 获取 跟 menu_share 
菜单 项 匹配 的 ShareActionProvider 对 象 ,调用 setShareIntent() 方 法 是 定义 要 用 于 共享 
的 Intent 对 象 。 

代码 4.25 中 定义 了 getDefaultIntent() 方 法 初始 化 Action Provider, 但 是 当 在 Intent 
中 实际 使 用 的 内 容 设 定 或 改变 时 ,必须 调用 mShareActionProvider. setShareIntent() 更 





图 4.9 ShareActionProvider 的 使 用 


` 
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新 共享 Intent。 
代码 4.25 使 用 ShareActionProvider 





代码 4. 25 中 ShareActionProvider 对 象 处 理 所 有 的 跟 这 个 菜单 项 有 关 的 用 户 交互 ， 
并 且 不 需要 处 理 来 自 onOptionsItemSelected() 回调 方法 的 单 击 事件 。 如 果 需 要 重新 定 
义 菜单 项 的 功能 ,可 以 重 写 onOptionsItemSelected() 中 对 应 的 处 理 代码 。 代 码 4. 26 中 在 
onOptionsItemSelected() 回 调 方法 中 重 写 了 menu_share 菜单 项 的 单 击 事件 处 理 代码 , 因 
此 当 用 户 单 击 这 个 菜单 项 时 ,系统 不 再 执行 原 有 的 菜单 功能 ,而 是 实现 重 写 后 的 代码 。 
代码 4.26 Æ onOptionsItemSelected() 中 对 应 的 处 理 代码 
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Switch (item.getItemId ()) { 
case R.id.menu share: 
doShare(); 
break; 
default: 
break; 
) 
return true; 


} 


public void doShare(() { 
//populate the share intent with data 
Intent intent=new Intent (Intent.ACTION SEND); 
intent.setType ("text/plain"); 
intent .PutExtra (Intent .EXTRA TEXT, "This is a message for you"); 
provider.setShareIntent(intent); 
| 


默认 情况 下 ,ShareActionProvider 对 象 会 基于 用 户 的 使 用 频率 来 保留 共享 目标 的 排 
列 顺序 。 使 用 频率 高 的 目标 应 用 程序 会 显示 在 下 拉 列 表 的 上 面 , 并 且 最 常用 的 目标 会 作 
为 默认 共享 目标 直接 显示 在 动作 条 。 默 认 情况 下 ,排序 信息 被 保存 在 由 DEFAULT_ 
SHARE_HISTORY_FILE_NAME 指定 名 称 的 私有 文件 中 。 如 果 只 使 用 一 种 操作 类 型 
ShareActionProvider 类 或 它 的 一 个 子 类 ,可 以 继续 使 用 这 个 默认 的 历史 文件 ;但 是 ,如 果 
使 用 了 不 同类 型 的 多 个 操作 的 ShareActionProvider 类 或 它 的 子 类 , 则 需要 调用 
setShareHistoryFileName( ) 方 法 ,为 每 种 ShareActionProvider 类 都 指定 自己 独立 的 
XML 历史 文件 。 


425 自 定义 动作 提供 器 


要 创建 自己 的 动作 提供 器 ,只 需 继 承 类 ,并 且 实 现 合适 的 回调 方法 。 下 面 是 需要 实现 
的 几 个 重要 回调 方法 : 

。 ActionProvider() 。 构 造 方法 负责 传递 应 用 程序 的 Context 对 象 ,这 个 对 象 需要 
保存 在 一 个 成 员 变量 中 ,以 便 其 他 的 回调 方法 使 用 。 

。 OnCreateActionView() 。 在 这 个 方法 中 ,可 以 给 菜单 项 定义 动作 视图 。 使 用 从 构 
造 方法 中 接收 的 Context 对 象 ,实例 化 一 个 LayoutInflater 对 象 , 并 且 用 XML 资 
源 来 填充 动作 视图 ,然后 注册 事件 监听 器 ( 见 代码 4.27), 

代码 4.27 创建 自己 的 ActionProvider 动作 视图 


public View onCreateActionView() { 
//Inflate the action view to be shown on the action bar. 
LayoutInflater layoutInflater=LayoutInflater.from(mContext); 


Ne 
—— 
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View view=layoutInflater.inflate (R.layout.action provider, null); 
ImageButton button= (ImageButton) view.findViewById(R.id.button); 
button.setOnClickListener (new View.OnClickListener() ( 

@Override 

public void onClick (View v) { 

//Do something" 

} 
Ti 
return view; 


} 


。 onPerformDefaultAction() 。 系 统 会 在 选中 溢出 菜单 中 的 菜单 选项 时 ,调用 这 个 
方法 ,并且 动 作 提供 器 执行 这 个 选中 菜单 项 的 默认 操作 。 如 果 是 自 定义 的 动作 提 
供 器 ,使 用 onPrepareSubMenu() 回 调 方法 创建 了 子 菜单 ,即使 把 这 个 动作 提供 器 
放 在 溢出 菜单 中 , 子 菜单 也 会 显示 。 因 此 , 当 自 定义 动作 提供 器 中 子 菜单 存在 时 ， 
系统 不 会 回调 onPerformDefaultAction() 方 法 。 
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对 于 应 用 中 不 同 视图 之 间 的 切换 和 展现 ,动作 条 上 的 导航 标签 是 一 个 很 好 的 工具 ,而 
且 导 航标 签 适 用 于 在 不 同 的 屏幕 尺寸 上 显示 。 例 如 当 屏 幕 足 够 宽 , 导 航标 签 就 显示 在 动 
作 按 钮 旁 的 动作 条 上 ;而 屏幕 较 窗 时 ,导航 标签 就 显示 在 分 离 的 横 条 中 ( 见 图 4.10). 








o~ [o] 
toons mas monops paseas 
图 4. 10 导航 标签 


要 使 用 选项 标签 ,首先 用 户 界 面 的 布局 定义 中 必须 包含 一 个 ViewGroup 对 象 ,用 于 
放置 跟 每 个 Fragment 对 象 关 联 的 选项 标签 。 同 时 这 个 ViewGroup 对 象 需要 有 一 个 资源 
ID, 以 便 能 够 在 选项 标签 的 切换 代码 中 引用 它 。 如 果 选 项 标签 的 内 容 填充 在 Activity 的 
布局 中 , 则 此 Activity 不 需要 任何 布局 ,甚至 不 需要 调用 setContentView() 方 法 。 如 果 
把 每 个 Fragment 对 象 都 放 到 默认 的 根 ViewGroup 对 象 中 ,就 用 android. R. id. content 
ID 来 引用 这 个 ViewGroup 对 象 。 

Fragment 通常 作为 Activity 界面 的 一 部 分 组 成 出 现 ,并 可 将 它 的 Layout 提供 给 
Activity, Fragment 是 应 用 程序 的 一 部 分 ,可 以 用 Activity 来 替换 。 一 个 Activity 中 可 
以 同时 出 现 多 个 Fragment, 一 个 Fragment 亦 可 在 多 个 Activity 中 使 用 。 在 Activity 运 
行 过 程 中 ,可 以 添加 、 移 除 或 者 替换 Fragment(add() remove) replace())。Fragment 
可 以 响应 自己 的 输入 事件 ,并 且 有 自己 的 生命 周期 ,但 直接 受 其 所 属 的 宿主 Activity 的 生 
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命 周期 影响 。 

Fragment 在 应 用 中 呈现 为 一 个 模块 化 和 可 重用 的 组 件 。 将 Fragment 包含 到 多 个 
Activity 中 ,允许 应 用 程序 将 用 户 体验 适 配 到 不 同 的 屏幕 尺寸 。 例 如 , 当 在 屏幕 尺寸 足够 
大 时 ,在 一 个 Activity 中 可 以 包含 多 个 Fragment, 相 反 ,应 用 程序 会 启动 另 一 个 使 用 不 同 
Fragment 的 Activity, 

决定 了 Fragment 对 象 在 布局 中 的 显示 位 置 后 ,添加 选项 标签 的 基本 过 程 如 下 : 

(1) 实现 ActionBar. TabListener 接口 。 这 个 接口 中 回调 方法 会 响应 选项 标签 上 的 
用 户 事件 ,例如 用 户 单 击 , 切 换 Fragment 对 象 。 

(2) 在 初始 化 Activity 时 ,对 每 个 要 添加 的 选项 标签 ,都 实例 化 一 个 ActionBar. Tab 
对 象 ,并且 调 用 setTabListener() 方 法 设置 ActionBar. Tab 对 象 的 事件 监听 器 。 还 可 以 
用 setText() 或 setIcon() 方 法 来 设置 选项 标签 的 标题 或 图 标 。 

(3) 调用 addTab() 方 法 ,将 每 个 选项 标签 添加 到 动作 条 。 

ActionBar. TabListener 接口 的 回调 方法 并 没有 说 明 Fragment 和 Tab 之 间 的 联系 ， 
只 提供 了 被 选择 的 ActionBar. Tab 对 象 和 执行 Fragment 对 象 事务 的 FragmentTransaction 
对 象 。 因 此 ,必须 定义 每 个 ActionBar. Tab 与 Fragment 对 象 之 间 的 关联 。 根 据 设计 的 
不 同 , 有 很 多 种 不 同 的 方法 来 定义 这 种 联系 。 

下 面 用 一 个 例子 来 说 明 如 何 实现 动作 条 上 的 导航 标签 。 

首先 ,定义 实现 ActionBar. TabListener 接口 的 Tab 监听 器 类 。 在 TabListener 监听 
器 中 ,定义 一 个 指定 Activity、Fragment 和 Fragment 类 型 的 构造 方法 ,实现 Tab 被 选择 、 
被 重 选 和 不 选 几 个 动作 时 的 事件 处 理 ( 见 代码 4. 28) 。 

代码 4.28 实现 ActionBar. TabListener 接口 的 Tab 监听 器 类 


public static class TabListener<T extends Fragment > implements ActionBar. 
TabListener { 

private Fragment mFragment; 

private final Activity mActivity; 

private final String mTag; 

private final Class<T>mClass; 


/** Constructor used each time a new tab is created. 
* @param activity The host Activity, used to instantiate the fragment 
* @param tag The identifier tag for the fragment 
* @param clz The fragment's Class, used to instantiate the fragment 
*/ 
public TabListener (Activity activity, String tag, Class<T>clz) { 
mActivity=activity; 
mTag=tag; 
mClass=clz; 
li 
/* The following are each of the ActionBar.TabListener callbacks */ 
public void onTabSelected (Tab tab, FragmentTransaction ft) { 
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然后 ,在 显示 这 个 动作 条 的 Activity 的 onCreate() 方 法 中 ,创建 动作 条 和 ActionBar. 
Tab 对 象 ,注册 TabListener 监听 器 到 ActionBar. Tab 对 象 ,并 添加 到 动作 条 ActionBar。 
另外 ,必须 调用 setNavigationMode(ActionBar. NAVIGATION_MODE_TABS) 方 法 来 
让 选项 标签 可 见 。 如 果 选 项 标签 的 标题 实际 指示 了 当前 的 View 对 象 , 也 可 以 通过 调用 
setDisplayShowTitleEnabled(false) 方 法 来 禁用 Activity 的 标题 。 代 码 4. 29 实现 了 两 个 
导航 标签 。 

代码 4. 29 ”实现 导航 标签 
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.SetTabListener (new TabListener<ArtistFragment>( 
this, "artist", ArtistFragment.class)); 
actionBar.addTab (tab) ; 


tab=actionBar.newTab() 
.SetText (R.string.album) 
.SetTabListener (new TabListener<AlbumFragment> ( 
this, "album", AlbumFragment.class)); 
actionBar.addTab (tab) ; 
} 


在 某 些 情况 下 ,Android 系统 会 把 动作 条 选项 标签 作为 一 个 下 拉 列 表 来 显示 ,以 便 确 
保 动作 条 的 最 优化 显示 。 

上 面 有 关 ActionBar. TabListener 的 实现 ,只 是 几 种 可 能 的 技术 之 一 。 在 API 
Demos 应 用 中 能 够 看 到 更 多 的 这 种 样式 。 


427 应 用 导航 模式 


Android 系统 在 3.0 之 后 ,提供 了 更 灵活 的 导航 方式 。 

1. 使 用 应 用 图 标 

应 用 图 标 是 ActionBar 四 个 区 域 中 的 第 一 个 区 域 ,表示 应 用 程序 的 标识 ,需要 的 话 可 
以 使 用 不 同 的 logo 或 标牌 。 如 果 当 前 不 是 应 用 的 顶层 界面 , 则 在 图 标 左边 会 有 一 个 向 左 
的 箭头 ,表示 “向 上 ?按钮 ,使 用 户 可 以 回 到 上 一 级 界面 。 默 认 情况 下 ,应 用 程序 图 标 显 示 
在 动作 条 的 左边 ,可 以 作为 动作 选项 来 使 用 。 

在 这 个 应 用 图 标 上 ,应 用 程序 可 以 响应 两 种 操作 + 

。 返回 应 用 程序 的 主 Activity。 

。 向 应 用 程序 上 级 页 面 导航 。 

当 用 户 触 摸 这 个 图 标 时 ,系统 会 回调 Activity 的 onOptionsItemSelected() 方 法 ,响应 
这 个 事件 ,进行 运行 对 应 的 程序 代码 。 在 事件 处 理 代码 中 , 既 可 以 实现 主 Activity, 也 可 
以 返回 应 用 程序 层次 结构 中 的 用 户 上 一 步 操作 界面 。 

1) 返回 应 用 程序 的 主 Activity 

如 果 要 通过 应 用 图 标的 事件 响应 来 返回 主 Activity, 则 需 在 事件 处 理 代 码 中 设置 
Intent 对 象 中 包括 FLAG_ACTIVITY_CLEAR_TOP 标识 。 使 用 这 个 标识 后 ,如 果 要 启 
动 的 Activity 在 当前 任务 中 已 经 存在 , 则 堆栈 中 这 个 Activity 之 上 的 所 有 Activity 都 将 
被 销毁 ,并 且 把 这 个 Activity 显示 给 用 户 。 

添加 这 个 标识 非常 重要 ,否则 在 响应 事件 时 ,系统 会 再 创建 一 个 新 的 主 Activity K 
例 ,而 不 是 回 退 到 原 有 的 主 Activity ,最终 可 能 会 造成 在 当前 任务 中 产生 一 个 很 长 的 拥有 
多 个 主 Activity 的 堆栈 。 添 加 这 个 标识 ,相当 于 一 个 堆栈 的 回 退 动作 ,重新 调 出 堆栈 中 原 
有 的 主 Activity 实例 。 

代码 4. 30 示例 了 在 onOptionsItemSelected() 方 法 中 的 事件 处 理 代码 ,实现 了 返回 应 


`e 
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用 程序 的 主 Activity 的 操作 。 
代码 4.30 返回 应 用 程序 的 主 Activity 


@override 
public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) { 
case android.R.id.home: 
//app icon in action bar clicked; go home 
Intent intent=new Intent (this, HomeActivity.class); 
intent.addFlags (Intent.FLAG_ACTIVITY_CLEAR_TOP) ; 
startActivity (intent); 
return true; 
default: 
return super.onOptionsItemSelected(item); 


) 


为 了 适应 用 户 从 另 一 个 应 用 程序 进入 当前 Activity 的 情况 ,还 需要 添加 Intent 的 另 
一 个 FLAG_ACTIVITY_NEW_TASK 标识 ,使 用 户 在 返回 主页 或 上 级 页 面 时 ,系统 不 
会 把 新 的 Activity 添加 到 当前 的 任务 中 ,而 是 在 属于 自己 的 应 用 程序 任务 中 启动 。 

Android 4. 0 之 前 的 版 本 ,默认 情况 下 应 用 图 标 就 能 够 作为 一 个 操作 项 ;但 从 
Android 4. 0 版 本 开始 ,如 果 要 使 用 应 用 图 标 来 返回 主页 ,必须 调用 ActionBar 的 方法 
setHomeButtonEnabled( true) ,来 设 定 应 用 图 标 能 够 作为 一 个 操作 项 。 

2) 向 应 用 程序 上 级 页 面 导 航 

如 果 要 通过 应 用 图 标的 事件 响应 来 向 应 用 程序 上 级 页 面 导航 ,需要 通过 调用 
ActionBar 的 SetDisplayHomeAsUpEnabledtrue (true) 方 法 ( 见 代 码 4. 31), Æ 
onOptionsItemSelected() 实 现 事件 处 理 。 

代码 4.31 向 应 用 程序 上 级 页 面 导航 


protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


setContentView(R.layout .main); 
ActionBar actionBar=getActionBar(); 
actionBar.setDisplayHomeAsUpEnabled (true); 


} 


当 用 户 触 摸 这 个 图 标 时 ,系统 会 调用 带 有 android. R. id home ID 的 onOptionsItemSelected() 
方法 。 

2. 添加 下 拉 式 导航 

作为 Activity 内 部 的 另 一 种 导航 模式 ,动作 条 提供 了 内 置 的 下 拉 列 表 。 例 如 ,下 拉 列 


表 能 够 提供 Activity 中 内 容 的 不 同 排序 模式 。 
启用 下 拉 式 导航 的 基本 过 程 如 下 : 
(1) 创建 一 个 给 下 拉 提 供 可 选项 目的 列表 ,以 及 显示 选项 时 所 使 用 的 布局 。 
(2) 实现 ActionBar. OnNavigationListener 接口 ,定义 用 户 选 项 时 的 事件 处 理 代码 。 
(3) 在 Activity 的 onCreate() 方 法 中 ,调用 setNavigationMode() 方 法 ,启用 动作 条 
的 下 拉 式 导航 模式 。 代 码 如 下 : 


(4) 用 ActionBar 的 setListNavigationCallbacks() 方 法 给 下 拉 列 表 设 置 回 调 方法 。 
代码 如 下 : 


这 个 方法 需要 SpinnerAdapter 和 ActionBar. OnNavigationListener 对 象 。 
下 面 使 用 一 个 简单 的 例子 来 说 明 如 何 具 体 实现 下 拉 式 导航 ( 见 代码 4. 32) 。 
代码 4.32 ”实现 下 拉 式 导航 
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sas mamata Na 
m 


args .putInt (DummySectionFragment.ARG SECTION NUMBER, position+1); 
fragment .setArguments (args); 
getFragmentManager () .beginTransaction () 
.replace (R.id.container, fragment) .commit (); 
return true; 


} 


xx 
* A dummy fragment 
s 


public static class DummySectionFragment extends Fragment { 
public static final String ARG SECTION_NUMBER="placeholder_text"; 


@Override 
public View onCreateView (LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) ( 
TextView textView=new TextView(getActivity()); 
textView.setGravity(Gravity.CENTER); 
textView.setText (Integer.toString (getArguments() .getInt (ARG_ 
SECTION NUMBER) ) ) ; 


return textView; 


4.3 本 章 小 结 


本 章 主 要 介绍 了 Android 系统 的 应 用 浏览 模式 中 菜单 和 动作 条 两 个 最 重要 的 组 件 。 

Android SDK 支持 丰富 的 菜单 类 型 ,包括 常规 的 菜单 、 子 菜单 、 上 下 文 菜 单 、 图 标 菜 
单 、 二 级 菜单 和 替代 菜单 。 其 中 选项 菜单 、 弹 出 菜单 和 上 下 文 菜单 是 菜单 的 三 个 基本 类 
型 。 菜 单项 由 android. view. Menultem 类 表示 , 子 菜单 由 android. view. SubMenu 类 表 
示 。 菜 单 的 创建 和 事件 处 理 与 其 他 视图 对 象 类 似 , 可 以 通过 XML 布局 文件 设计 菜单 ,使 
用 监听 器 或 菜单 的 回调 方法 来 处 理 菜单 选项 事件 。 

动作 条 (ActionBar) 是 位 于 Activity 顶端 的 一 个 图 形 控件 ,能 够 显示 Activity 的 标 
题 .图 标 、 可 能 触发 的 动作 、 附 加 视图 和 其 他 交互 控件 ,也 可 以 用 于 在 应 用 程序 中 导航 。 对 
于 大 多 数 应 用 ,动作 条 可 以 分 割 为 应 用 图 标 、 视 图 控制 、 动 作 按钮 和 溢出 动作 四 个 不 同 的 
功能 区 域 。 

动作 条 可 以 与 许多 控件 结合 使 用 ,例如 菜单 、 视 图 .标签 和 内 容 提供 器 等 组 件 , 为 
Android 用 户 界面 提供 了 丰富 的 显示 模式 。 
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发 送 和 接收 消息 


5.1 理解 Intent 


什么 是 Intent W? Intent 是 连接 Android 组 件 的 纽带 ,专门 用 于 携带 需要 传递 的 信 
息 。 当 某 个 组 件 创建 一 个 Intent 对 象 并 发 送 后 ,Android 系统 会 根据 这 个 Intent 携带 的 
信息 激活 对 应 的 其 他 组 件 , 也 就 是 启动 这 些 组 件 ,执行 这 些 组 件 的 代码 。 这 个 Intent 对 
象 中 同时 携带 触发 其 他 组 件 执行 的 条 件 信息 和 触发 后 该 组 件 执行 时 所 需要 的 信息 。 


5.1.1 Intent 的 概念 


由 于 Android 是 一 个 基于 有 限 资源 的 操作 系统 , Android 的 基本 设计 理念 是 鼓励 减 
少 组 件 的 耦合 ,因此 Android 提供 了 Intent 机 制 一 种 通用 的 消息 系统 。Android 的 
一 个 应 用 程序 与 其 他 的 应 用 程序 之 间 通 过 传递 Intent 对 象 来 执行 动作 和 产生 事件 。 通 
过 Intent 的 消息 触发 .消息 传递 .消息 响应 来 实现 窗口 跳 转 、 传 递 数据 或 调用 外 部 程序 ， 
进行 应 用 程序 的 激活 和 调用 。 

Android 的 基础 组 件 Activity、Service 和 BroadcastReceiver, 都 可 以 通过 定义 Intent 
的 消息 ,实现 在 各 组 件 之 间 的 程序 跳 转 和 数据 传递 ,也 就 是 Intent 的 消息 可 以 激活 其 他 
组 件 。 从 程序 的 角度 来 看 ,在 Android 中 ,Intent 相当 于 各 个 Activity 之 间或 其 他 类 型 基 
础 组 件 的 桥梁 ,可 以 传递 数据 ,还 可 以 通过 Intent 启动 男 外 一 个 基础 组 件 。 

例如 ,从 一 个 窗口 单 击 一 个 链接 ,用 浏览 器 打开 另 一 个 页 面 时 , 既 要 启动 浏览 器 程序 ， 
又 要 把 链接 传递 给 浏览 器 ,这 时 Android 应 用 程序 就 可 以 在 第 一 个 Activity 中 创建 一 个 
Intent 对 象 , 在 Intent 对 象 把 链接 的 数据 封装 ,然后 通过 Android 系统 传递 给 浏览 器 程 
序 , 并 启动 浏览 器 。 

抽象 地 说 ,Intent 消息 是 同一 个 应 用 程序 或 不 同 应 用 程序 运行 后 ,组 件 间 进行 绑 定 的 
一 种 能 力 。 通 过 Intent 消息 ,把 不 同 的 组 件 与 用 户 的 操作 联系 起 来 ,例如 在 一 个 Activity 
上 单 击 一 个 按钮 就 打开 另 一 个 显示 照片 的 Activity, 而 单 击 链接 则 打开 一 个 浏览 器 。 

具体 来 说 ,Intent 对 象 包含 要 执行 的 操作 或 需要 传递 的 消息 ,或 者 在 广播 的 情况 下 ， 
包含 一 些 已 经 发 生 或 正在 发 生 的 事情 的 描述 。 

举 个 例子 ,在 一 个 联系 人 维护 的 应 用 中 , 当 我 们 在 一 个 联系 人 列表 屏幕 (假设 对 应 的 
Activity 为 listActivity) 上 , 单 击 某 个 联系 人 后 ,希望 能 够 跳出 此 联系 人 的 详细 信息 屏幕 
(假设 对 应 的 Activity 为 detailActivity) ,在 两 个 Activity 之 间 , 需 要 传递 “联系 人 ”的 信 
息 , 这 个 工作 由 Intent 完成 。 
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5.1.2 Intent 对 象 的 组 成 


一 个 Intent 对 象 就 是 一 个 信息 包 。 它 包含 了 接收 这 个 Intent 对 象 的 组 件 所 感 兴趣 
的 信息 (如 要 执行 的 动作 和 动作 相关 的 数据 ) 和 Android 系统 感 兴趣 的 信息 (如 处 理 这 个 
Intent 对 象 的 组 件 的 分 类 和 有 关 如 何 启动 目标 Activity 的 指令 )。Intent 为 这 些 不 同 的 
信息 定义 了 对 应 的 属性 ,我 们 通过 设 定 所 需 的 属性 值 ,就 可 以 把 数据 从 一 个 Activity 传递 
到 另 一 个 Activity。 

Intent 对 象 可 绑 定 的 信息 如 下 : 

。 ComponentName: 需要 启动 的 Activity 的 名 字 。 

。 Action: 指定 了 要 访问 的 Activity 需要 做 什么 。 

。 Data: 需要 传递 的 数据 。 

Category: 给 出 一 些 Action 的 额外 执行 信息 。 
。 Extras: 需要 传递 的 额外 信息 ,以 键 值 对 形式 传递 。 
Flags: 标记 Activity 启动 的 方式 。 

但 是 Intent 对 象 在 绑 定 信息 时 ,并 不 是 所 有 的 信息 都 必须 设置 ,而 只 是 选 定 需要 携 
带 的 信息 绑 定 到 Intent 对 象 ,也 就 是 设 定 Intent 对 象 的 对 应 属性 的 值 。 

1. ComponentName 

Intent 的 组 件 名 称 对 象 由 ComponentName 类 封装 。 也 就 是 说 ,Intent 定义 了 一 个 属 
性 描述 Intent 将 要 激活 或 启动 的 Android 组 件 名 称 , 这 个 组 件 可 以 是 一 个 Activity、 
Service, BroadcastReceiver 或 者 ContentProvider。 Intent 的 这 个 属性 值 是 一 个 
ComponentName 类 的 对 象 ,我 们 无 法 直接 访问 它 , 但 可 以 通过 getComponentName ( ) 
获取 。 

ComponentName 类 包含 两 个 String 成 员 ,分别 代表 Android 组 件 的 全 称 类 名 和 包 
名 , 包 名 必须 和 AndroidManifest. xml 文件 中 标记 中 的 对 应 信息 一 致 。 也 就 是 说 ,这 个 
Intent 对 象 所 要 激活 或 启动 的 Android 组 件 , 已 经 在 AndroidManifest. xml 中 进行 了 
描述 。 

对 于 Intent, 组 件 名 并 不 是 必需 的 。 如 果 一 个 Intent 对 象 添 加 了 组 件 名 , 则 称 该 
Intent H“ Intent” ,这样 的 Intent 在 传递 时 会 直接 根据 组 件 名 去 寻找 目标 组 件 。 如 
果 没 有 添加 组 件 名 , 则 称 为 “ 隐 式 Intent”, Android 会 根据 Intent 中 的 其 他 信息 来 确定 响 
应 该 Intent 的 组 件 。 打 个 比方 ,老师 在 让 学 生 回 答 问 题 时 ,老师 说 :“ 张 三 请 回答 问题 ”， 
这 就 是 显 式 Intent, 直接 指 出 了 回答 问题 的 人 ;老师 说 :“ 请 第 二 排 第 三 个 同学 回答 问 
题 ”, 这 就 是 隐 式 Intent, 给 出 了 回答 问题 学 生 的 条 件 ,学 生根 据 自 己 的 座位 来 确认 是 谁 来 
回答 问题 。 

2. Action 

Action 是 描述 要 求 Android 系统 所 执行 动作 的 一 个 属性 , 值 是 一 个 字符 串 常量 , 代 
Android 组 件 所 可 能 执行 的 一 些 操作 ,如 启动 Activity 发 出 警告 等 。Android 系统 中 
已 经 预定 义 了 一 些 Action 常量 ,开发 者 也 可 以 定义 自己 的 Action 描述 。Android 定义 了 
一 套 标 准 Action 的 值 ,其 中 最 重要 的 和 最 常用 的 Action 操作 是 ACTION_MAIN 和 
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ACTION_EDIT, 见 表 5. 1。 


表 5.1 标准 的 Action 操作 





标准 的 Activity Actions 


标准 的 Broadcast Actions 





ACTION_MAIN 
ACTION_VIEW 
ACTION_ATTACH_DATA 
ACTION_EDIT 
ACTION_PICK 
ACTION_CHOOSER 
ACTION_GET_CONTENT 
ACTION_DIAL 
ACTION_CALL 
ACTION_SEND 
ACTION_SENDTO 
ACTION_ANSWER 
ACTION_INSERT 
ACTION_DELETE 
ACTION_RUN 
ACTION_SYNC 
ACTION_PICK_ACTIVITY 
ACTION_SEARCH 
ACTION_WEB_SEARCH 
ACTION_FACTORY_TEST 





ACTION_TIME_TICK 
ACTION_TIME CHANGED 
ACTION_TIMEZONE_CHANGED 
ACTION_BOOT_COMPLETED 
ACTION_PACKAGE_ADDED 
ACTION_PACKAGE_ CHANGED 
ACTION_PACKAGE_REMOVED 
ACTION_PACKAGE_RESTARTED 
ACTION_PACKAGE_DATA_CLEARED 
ACTION_UID REMOVED 
ACTION_BATTERY_CHANGED 
ACTION_POWER_CONNECTED 
ACTION_POWER_DISCONNECTED 
ACTION_SHUTDOWN 


假如 这 个 属性 定义 了 ACTION_MAIN 动作 , 则 表示 接收 Intent 对 象 传递 信息 的 
Activity 进行 初始 化 和 启动 操作 ,并 且 不 需要 数据 输入 也 没有 返回 值 输出 o 

假如 这 个 属性 定义 了 ACTION_BATTERY_LOW 动作 , 当 电 池 电 量 低 时 ,系统 会 使 
用 Intent 对 象 传递 这 个 信息 给 BroadcastReceiver 组 件 。 


下 面 是 Action 和 后 面 携带 相关 数据 的 例子 : 


ACTION VIEW content://contacts/people/1 
ACTION DIAL content://contacts/people/1 
ACTION DIAL tel:123 

ACTION EDIT content://contacts/people/1 
ACTION VIEW content://contacts/people/ 


-- 显 示 标 识 为 "1" 的 联系 人 信息 
-- 显 示 可 填写 的 电话 拨号 器 

-- 显 示 带 有 号 码 的 拨号 器 

- -编辑 标识 为 "1" 的 联系 人 信息 
- -显示 联系 人 列表 


在 Java 中 使 用 setAction() 来 设置 Intent 的 Action 属性 ,使 用 getAction() 来 获得 


Action 属性 。 


3. Data 


Data 部 分 描述 了 Android 系统 执行 与 Action 相关 的 动作 时 所 激活 的 其 他 组 件 执行 


时 需要 的 数据 .数据 MIME 类 型 和 URI, 不 同 的 Action 对 应 不 同 的 操作 数据 。 例 如 ,如 
果 动 作 字段 是 ACTION_EDIT ,数据 字段 将 包含 将 显示 用 于 编辑 的 文档 的 URI; 如 果 动 
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作 是 ACTION _CALL, 数 据 字 段 将 是 一 个 tel: URI 和 将 拨打 的 号 码 ; 如 果 动 作 是 
ACTION_VIEW ,数据 字段 是 一 个 http:URI, 接 收 活动 将 被 调用 去 下 载 和 显示 URI 指向 
的 数据 。 

当 Android 系统 根据 一 个 Intent 匹配 对 应 的 组 件 时 ,通常 知道 数据 的 类 型 ( 它 的 
MIME 类 型 ) 和 它 的 URI 很 重要 。 例 如 ,一 个 能 够 显示 图 像 数 据 的 组 件 , 就 不 应 该 在 播放 
一 个 音频 文件 时 被 激活 。 

在 许多 情况 下 ,能够 从 URI 中 推测 数据 类 型 ,特别 是 content:URIs, 它 表示 位 于 设备 
上 的 数据 且 被 ContentProvider 控制 。 但 是 也 能 够 显示 地 设置 类 型 ,使 用 Intent 的 
setData() 方 法 指定 数据 的 URI、setType() 指 定 MIME 类 型 ,setDataAndType() 指 定数 
据 的 URI 和 MIME 类 型 。 被 激活 执行 的 Activity 中 ,获取 Intent 对 象 后 ,通过 Intent 的 
getData() 读 取 URI、getType() 读 取 类 型 。 

Data 部 分 的 数据 类 型 是 由 Action 的 值 决定 的 ,下 面 给 出 的 几 个 例子 可 以 看 出 ， 
Action 部 分 的 不 同 ,决定 了 数据 部 分 的 值 不 同 。 


ACTION VIEW content://contacts/1 -- 显 示 标 识 符 为 "1" 的 联系 人 的 详细 信息 
ACTION EDIT content://contacts/1 -- 编 辑 标 识 符 为 "1" 的 联系 人 的 详细 信息 
ACTION VIEW content://contacts/ -- 显 示 所 有 联系 人 的 列表 


-- 显 示 所 有 联系 人 的 列表 ,并 且 人 允许 用 户 在 列表 
中 选择 一 个 联系 人 ,然后 把 这 个 联系 人 返回 给 
父 Activity 


ACTION PICK content://contacts/ 


4. Category 

Category 主要 描述 被 请 求 组 件 或 执行 行为 动作 的 额外 信息 。Android 系统 也 为 类 别 
定义 了 一 系列 的 静态 常量 字符 串 来 表示 Intent 的 不 同类 别 , 其 中 标准 的 类 别 定义 见 
表 5.2。 


35.2 标准 的 Category 和 Extras 


Standard Category 


Standard Extra Data 





CATEGORY_DEFAULT 
CATEGORY_BROWSABLE 
CATEGORY_TAB 
CATEGORY_ALTERNATIVE 
CATEGORY_SELECTED_ALTERNATIVE 
CATEGORY_LAUNCHER 
CATEGORY_INFO 
CATEGORY_HOME 
CATEGORY_PREFERENCE 
CATEGORY_TEST 
CATEGORY_CAR_DOCK 





EXTRA_ALARM_COUNT 
EXTRA_BCC 

EXTRA_CC 

EXTRA _CHANGED_COMPONENT_NAME 
EXTRA _DATA_REMOVED 

EXTRA _DOCK_STATE 
EXTRA_DOCK_STATE_HE_DESK 

EXTRA _DOCK_STATE_LE_DESK 

EXTRA _DOCK_STATE_CAR 

EXTRA _DOCK_STATE_DESK 

EXTRA _DOCK_STATE_UNDOCKED 
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续 表 
Standard Category Standard Extra Data 
CATEGORY_DESK_DOCK EXTRA_DONT_KILL_APP 
CATEGORY_LE_DESK_DOCK EXTRA_EMAIL 
CATEGORY_HE_DESK_DOCK EXTRA_INITIAL_INTENTS 
CATEGORY_CAR_MODE EXTRA_INTENT 
CATEGORY_APP_MARKET EXTRA_KEY_EVENT 


EXTRA_ORIGINATING_URI 
EXTRA _PHONE_NUMBER 
EXTRA_REFERRER 
EXTRA_REMOTE_INTENT_TOKEN 
EXTRA_REPLACING 
EXTRA_SHORTCUT_ICON 

EXTRA _SHORTCUT_ICON_RESOURCE 
EXTRA_SHORTCUT_INTENT 
EXTRA_STREAM 
EXTRA_SHORTCUT_NAME 
EXTRA_SUBJECT 
EXTRA_TEMPLATE 





EXTRA_TEXT 
EXTRA_TITLE 
EXTRA_UID 
5. Extras 
主要 描述 组 件 的 扩展 信息 或 额外 的 数据 。Android 也 定义 了 标准 的 Extra Data 常 
量 , 见 表 5.2。 


Extras 采用 键 值 对 的 结构 ,以 Bundle 对 象 的 形式 保存 在 Intent 当中 。 附 加 信息 其 
实 是 一 个 类 型 安全 的 容器 ,其 实现 就 是 将 HashMap 做 了 一 层 封装 。 

Intent 对 象 有 一 系列 的 put…() 方 法 用 于 插 和 人 各 种 附加 数据 和 一 系列 的 get…() 方 法 
用 于 读 取 数 据 。 这 些 方法 与 Bundle 对 象 的 方法 类 似 。 实 际 上 , Extras 可 以 作为 一 个 
Bundle ,使 用 putExtras() 和 getExtras() 方 法 安装 和 读 取 。 

例如 ,如 果 要 执行 “发 送 电子 邮件 ”这 个 动作 ,可 以 将 电子 邮件 的 标题 \ 正 文 等 保存 在 
Extras 里 , 传 给 电子 邮件 发 送 组 件 。 

6. Flags 

Flags 主要 标示 如 何 触发 目标 组 件 以 及 如 何 看 待 被 触发 的 目标 组 件 。 例 如 标示 被 触 
发 的 组 件 应 该 属于 哪 一 个 任务 或 者 触发 的 组 件 是 否 是 最 近 的 Activity 等 。Flags 可 以 是 
多 个 标示 符 的 组 合 。 

Android 有 各 种 各 样 的 标志 ,指示 Android 系统 如 何 去 启 动 一 个 Activity (例如 ， 
Activity 应 该 属于 那个 任务 ) 和 启动 之 后 如 何 对 待 它 ( 例 如 , 它 是 否 属于 最 近 的 活动 列 
表 )。 所 有 这 些 标志 都 定义 在 Intent 类 中 。 其 可 用 的 常量 包括 FLAG_ACTIVITY_ 
CLEAR_TOP、FLAG_ACTIVITY_NEW_TASK、FLAG_ACTIVITY_NO_HISTORY、 
FLAG_ACTIVITY_SINGLE_TOP 。 
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5.1.3 Intent 解析 


当 一 个 Activity 创建 并 发 出 一 个 Intent 对 象 后 ,其 他 的 Activity 或 基础 组 件 可 能 因 
为 与 这 个 Intent 对 象 携带 的 信息 相关 而 被 启动 。 一 个 Activity 或 其 他 基础 组 件 实现 在 各 
组 件 之 间 的 程序 跳 转 和 数据 传递 ,可 以 通过 Intent 的 两 种 不 同方 式 来 实现 : 显 式 和 隐 式 。 

(1) E Intent: 指 在 Activity 或 其 他 组 件 创建 Intent 对 象 时 ,通过 Component 
Name 显 式 地 设 定 所 希望 启动 .激活 或 接收 这 个 Intent 对 象 的 目标 组 件 ( 如 Service) 名 称 ， 
当 这 个 Activity 发 送 这 个 Intent 对 象 后 ,由 Android 系统 自动 启动 或 激活 Component 
Name 指定 的 Android 组 件 ,接收 这 个 Intent 对 象 携带 的 其 他 信息 。 因 为 有 时 开发 者 不 
知道 其 他 应 用 的 Component 名 称 , 显 式 方式 常用 于 自己 应 用 内 部 的 消息 传递 ,比如 应 用 
中 一 个 Activity 启动 一 个 相关 的 Service 或 者 启动 一 个 相关 的 Activity。 

(2) 隐 式 Intent: 创建 Intent 对 象 的 组 件 ,并 不 指定 目标 组 件 的 名 字 , 即 Component 
Name 字段 为 空 , 当 这 个 Activity 发 送 这 个 Intent 对 象 后 ,Android 系统 通过 Intent 对 象 
中 的 其 他 信息 与 目标 组 件 的 Intent 过 滤器 中 的 设置 相 匹配 ,来 启动 或 激活 相关 的 
Activity „Service 或 BroadcastReceiver 等 目标 组 件 。 隐 式 Intent 经 常用 于 激活 其 他 应 用 
程序 中 的 组 件 。 

对 于 接收 隐 式 的 Intent 的 Android 组 件 来 说 ,需要 在 AndroidManifest. xml 中 设 定 
接收 Intent 对 象 的 策略 。 当 Android 系统 在 处 理 Intent 对 象 时 ,把 Intent 对 象 中 携带 的 
信息 与 应 用 程序 中 组 件 设 定 的 Intent 过 滤 策 略 逐 个 相 比 较 , 判 断 该 组 件 是 否 符合 启动 或 
接收 的 条 件 。 也 就 是 说 ,通过 设 定 Intent 过 滤 策 略 条 件 ,可 以 指示 Android 系统 在 什么 时 
候 启动 并 把 Intent 对 象 传递 给 自己 。 

下 面 是 一 个 使 用 Intent Filter 的 例子 。 


<activity android:name=".IntentExampleActivity"> 
<intent-filter> 
<action android:name="com.android.activity.MY ACTION"/> 
<category android:name="android.intent.category.DEFAULT"/> 
</intent-filter> 


</activity> 


这 是 在 AndroidManifest. xml 文件 中 IntentExampleActivity 的 声明 代码 。 当 系统 
中 其 他 的 Activity 发 送出 一 个 Intent 对 象 ,并 且 这 个 Intent 对 象 的 Action 属性 的 值 为 
“MY_ACTION” 时 ,Android 系统 会 启动 IntentExampleActivity 应 用 程序 。 

如 果 一 个 组 件 没 有 声明 任何 Intent 过 滤器 , 它 仅 能 接收 显 式 的 Intent, 也 就 是 被 显 式 
Intent 对 象 启动 或 激活 ;而 声明 了 Intent 过 滤器 的 组 件 可 以 接收 显 式 和 隐 式 的 Intent. 

并 非 Intent 对 象 中 所 有 的 信息 都 会 用 于 过 滤器 的 匹配 ,只 有 Action、Data( 包 括 URI 
和 数据 类 型 ) Category 三 个 字段 才 被 考虑 。 

下 面具 体 讨论 一 下 Intent 过 滤器 及 其 检测 方法 。 

1. Intent 过 滤器 

Intent 过 滤器 是 由 intent-filter 标记 来 设置 的 。Activity、Service、BroadcastReceiver 
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为 了 告知 Android 系统 能 够 处 理 哪 些 隐 式 Intent, 可 以 设置 一 个 或 多 个 条 件 , 说 明 该 组 件 
可 接收 的 Intent 对 象 , 过 滤 掉 不 想 接收 的 隐 式 Intent 对 象 。 

除了 BroadcastReceiver 通过 调用 Context. registerReceiver() 动 态 地 注册 ,直接 创建 
一 个 Intent Filter 对 象 外 ,其 他 的 Intent 过 滤器 必须 在 AndroidManifest. xml 文件 中 进 
行 声 明 。 可 用 于 Intent 过 滤器 的 Intent 字段 有 三 个 : Action Data 和 Category, 

在 Android 系统 通过 组 件 的 Intent 过 滤器 检测 隐 式 Intent 时 ,要 检测 所 有 这 三 个 字 
段 ,其 中 任何 一 个 字段 匹配 失败 ,系统 都 不 会 把 这 个 隐 式 Intent 给 该 组 件 。 但 每 个 字段 
可 以 用 intent-filter 设置 多 个 条 件 , 每 个 设 定 的 条 件 之 间 相 互 独立 ,只 要 其 他 组 件 发 送出 
的 隐 式 Intent 对 象 符合 其 中 的 一 个 条 件 , 就 能 够 被 Android 系统 启动 或 接收 。 

2. Action 检测 

在 AndroidManifest. xml 文件 中 ,对 Action 字段 设置 过 滤 条 件 , 在 二 intent-filter> 
元 素 下 使 用 一 action 二 子 元素 及 其 属性 android:name 来 设置 可 接收 的 Action 字段 的 值 。 
例如 : 


<intent-filter> 
<action android:name="com.example.project .SHOW CURRENT" /> 
<action android:name="com.example.project.SHOW RECENT" /> 
<action android:name="com.example.project .SHOW PENDING" /> 
</intent-filter> 


根据 例子 设置 的 过 滤 策略 ,只 要 Action 字段 的 值 符合 上 面 列 出 之 一 的 Intent, 都 可 
以 被 这 个 组 件 接收 。 虽 然 一 个 Intent 对 象 的 Action 只 有 一 个 值 , 但 是 一 个 过 滤器 可 以 列 
出 不 止 一 个 ,接收 多 种 类 型 Action 的 Intent 对 象 。 

值得 注意 的 是 ,二 intent-filter 过 元素 下 必须 至 少 包含 一 个 二 action 二 子 元 素 ,否则 它 
将 阻塞 所 有 的 intents。 要 通过 检测 ,Intent 对 象 中 指定 的 动作 必须 匹配 Intent 过 滤器 的 
Action 列表 中 的 一 个 。 如 果 过 滤器 没有 一 action 二 子 元 素 ,将 没有 一 个 Intent 匹配 ,所 有 
的 Intent 都 会 检测 失败 ,没有 Intent 能 够 通过 过 滤器 。 

3. Category 检测 

类 似 Action 检测 ,在 二 intent-filter > Jú R F f# H] < category > F Ji # É F J8 FE 
android: name 列 出 可 接收 的 Category 字段 的 值 。 例 如 : 


<intent-filter => 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="android.intent.category.BROWSABLE" /> 


</intent-filter> 


在 Intent 对 象 中 可 以 含有 多 个 Category, < intent-filter 二 中 可 以 设置 多 个 
<category >, H Intent 中 的 所 有 Category 都 能 匹配 到 一 intentfilter 之 中 的 一 category 二 ， 
Intent 才能 通过 检测 。 也 就 是 说 ,如 果 Intent 对 象 中 的 Category RA Æ< intent-filter> 
中 过 category 之 的 集合 的 子 集 时 ,Intent 对 象 才 能 通过 检查 。 如 果 Intent 对 象 中 没有 设 
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置 Category 的 值 , 则 它 能 通过 所 有 一 intent-filter 之 的 一 category 二 检查 。 

如 果 一 个 Intent 能 够 通过 不 止 一 个 组 件 的 天 intentfilter 过 ,系统 可 能 会 询问 哪个 组 
件 被 激活 。 如 果 找 不 到 目标 组 件 ,会 产生 一 个 异常 。 

4. Data 检测 

284009 Æ<intent-filter> t% FEH —<data> Jú # K HJR FE T hy Data 字段 的 
值 。 例如: 


<intent=filter s> 
<data android:mimeType="video/mpeg" android:scheme="http" … /> 
<data android:mimeType="audio/mpeg" android:scheme="http" * /> 


</intent-filter> 


每 个 二 data 二 元 素 可 以 指定 一 个 URI 和 数据 类 型 (MIME 类 型 )。 对 应 于 URI 的 
scheme、host、port、path 四 个 部 分 ,一 data 二 元 素 分 别 使 用 属性 android:scheme、android: 
host.android:port.android:path 来 设置 。 下 面 是 URI 的 格式 和 一 个 例子 。 


scheme://host:port/path 
content://com.example.project:200/folder/subfolder/etc 


scheme 是 content, host 是 " com. example. project", port 是 200, path 是 "folder/ 
subfolder/etc", host 和 port 一 起 构成 URI 的 凭据 (authority) ,如 果 host 没有 指定 ,port 
也 被 忽略 。 这 四 个 属性 都 是 可 选 的 ,但 它们 之 间 并 不 都 是 完全 独立 的 。 要 让 authority 有 
意义 ,scheme 必须 也 要 指定 。 要 让 path 有 意义 ,scheme 和 authority 也 都 必须 要 指定 。 

当 比 较 Intent 对 象 和 过 滤器 的 URI 时 ,仅仅 比较 过 滤器 中 出 现 的 URI 属性 。 例 如， 
如 果 一 个 过 滤器 仅 指定 了 scheme, 所 有 有 此 scheme 的 URI 都 匹配 过 滤器 ;如 果 一 个 过 
滤器 指定 了 scheme 和 authority, 但 没有 指定 path, 所 有 匹配 scheme 和 authority 的 URI 
都 通过 检测 ,而 不 管 它们 的 path; 如 果 四 个 属性 都 指定 了 ,要 都 匹配 才能 算是 匹配 。 然 
而 ,过 滤器 中 的 path 可 以 包含 通配符 来 要 求 匹配 path 中 的 一 部 分 。 

二 data 记 元 素 的 mimeType 属性 指定 数据 的 MIME 类 型 。Intent 对 象 和 过 滤器 都 可 
以 用 " * "通配符 匹配 子 类 型 字段 ,例如 "text/ * ","audio/ * "表示 任何 子 类 型 。 

在 Data 检测 时 ,系统 既 要 检测 URI, 也 要 检测 MIME 类 型 。 检 测 的 规则 如 下 : 

(1) 一 个 Intent 对 象 既 不 包含 URI, 也 不 包含 MIME 类 型 : 仅 当 过 滤器 也 不 指定 任 
何 URI 和 MIME 类 型 时 , 才 不 能 通过 检测 ;否则 都 能 通过 。 

(2) 一 个 Intent 对 象 包含 URI, 但 不 包含 MIME 类 型 : 仅 当 过 滤器 也 不 指定 MIME 
类 型 ,同时 它们 的 URI 匹配 ,才能 通过 检测 。 例 如 ,mailto: 和 tel: 都 不 指定 实际 数据 。 

G) — Intent 对 象 包含 MIME 类 型 ,但 不 包含 URI: 仅 当 过 滤器 也 只 包含 MIME 
类 型 且 与 Intent 相同 , 才 通过 检测 。 

(4) 一 个 Intent 对 象 既 包含 URI, 也 包含 MIME 类 型 (或 MIME 类 型 能 够 从 URI 推 
断 出 ): MIME 类 型 部 分 ,只 有 与 过 滤器 中 之 一 匹配 才 算 通过 ;URI 部 分 , 它 的 URI 要 出 
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现在 过 滤器 中 ,或 者 它 有 content: 或 file: URI, 又 或 者 过 滤器 没有 指定 URI。 换 名 话说， 
如 果 它 的 过 滤器 仅 列 出 了 数据 类 型 ,组 件 假定 支持 content; 和 file: o 

如 果 一 个 Intent 能 够 通过 不 止 一 个 组 件 的 一 intentfilter 之 ,系统 可 能 会 询问 哪个 组 
件 被 激活 。 如 果 找 不 到 目标 组 件 ,会 产生 一 个 异常 。 

例如 ,Android 一 个 名 为 Note Pad 的 应 用 程序 ,允许 用 户 浏览 便签 ,查看 每 条 便签 的 
内 容 。 这 个 程序 在 Manifest 文件 中 可 以 按 代码 5. 1 来 设置 Intent 过 滤器 ,使 其 可 以 根据 
需要 被 系统 激活 。 

代码 5.1 应 用 程序 的 Intent 过 滤器 设置 
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在 代码 5.1 中 ,可 知 此 应 用 程序 定义 了 三 个 Activity, 每 一 个 Activity 都 定义 了 多 个 
Intent 模板 。 其 中 命名 为 com. android. notepad. NotesList 的 第 一 个 Activity 作为 进入 
应 用 程序 的 主 入 口 ,通过 定义 三 个 Intent 过 滤器 ,可 以 做 三 件 事情 。 

第 一 个 Intent 过 滤 模 板 代码 如 下 : 
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Action 设置 为 标准 MAIN ,表示 这 个 Activity 提供 了 进入 NotePad 应 用 程序 的 顶级 
入 口 ,Category 设置 为 LAUNCHER 表示 这 个 人 口 应 该 列 人 应 用 程序 启动 列表 。 
第 二 个 Intent 过 滤 模 板 代码 如 下 : 


<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<action android:name="android.intent.action.EDIT" /> 
<action android:name="android.intent.action.PICK" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<data mimeType:name="vnd.android.cursor.dir/vnd.google.note" /> 
</intent-filter> 


Action 设置 为 VIEW、EDIT 和 PICK 表示 这 个 Activity 可 以 对 便签 目录 所 作 的 操 
作 , 人 允许 用 户 浏 览 、 编 辑 和 挑选 便签 。Category 设置 DEFAULT 表示 如 果 这 个 Activity 
的 组 件 名 没有 显示 说 明 ,还 需要 通过 Context. startActivity() 方 法 来 启动 这 个 Activity, 
第 三 个 Intent 过 滤 模 板 代码 如 下 : 


<intent-filter> 
<action android:name="android.intent.action.GET CONTENT" /> 
<category android:name="android.intent .category.DEFAULT" /> 
<data android:mimeType="vnd.android.cursor.item/vnd.google.note" /> 
</intent-filter> 


vnd. android. cursor. item/ vnd. google. note 是 指示 vnd. android. cursor. item 资源 中 
确切 指定 的 一 个 URI, 也 就 是 vnd. google. note。Data 的 type 的 设置 表示 指定 类 型 的 数 
据 可 以 被 这 个 Activity 检索 。Action 设置 为 GET_CONTENT 与 PICK 类 似 。 这 个 设置 
表示 当 type 为 vnd. android. cursor. item/ vnd. google. note 时 ,返回 给 调用 者 一 个 用 户 选 
择 的 便签 ,而 用 户 不 需要 知道 便签 是 从 哪里 读 取 的 。 

通过 这 三 个 过 滤 模 板 的 设置 ,如 果 系 统 中 出 现 携带 下 面 信息 的 Intent, NotesList 这 
个 Activity 就 会 被 激活 执行 。 

(1) {action=android. app. action. MAIN}: 与 此 Intent 匹配 的 Activity ,将 会 被 当 作 
进入 应 用 的 顶级 入 口 。 

(2) {action = android. app. action. MAIN, category = android. app. category. 
LAUNCHER) : 这 是 目前 Launcher 实际 使 用 的 Intent, 用 于 生成 Launcher 的 顶级 列表 。 

(3) {action = android. app. action. VIEW , data = content: //com. google. provider. 
NotePad/notes}: 显示 "content://com. google. provider. NotePad/notes" 下 的 所 有 便 得 
的 列表 ,使 用 者 可 以 遍历 列表 ,并且 查 看 某 便签 的 详细 信息 。 

(4) {action = android. app. action. PICK , data = content://com. google. provider. 
NotePad/notes}: 显示 "content://com. google. provider. NotePad/notes" F ESIK , 
让 用 户 可 以 在 列表 中 选择 一 个 ,然后 将 选择 的 便签 的 URL 返回 给 调用 者 。 
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{action= android.app.action.GET CONTENT, type= vnd. android. cursor.item/ 
vnd.google 


下 面 我 们 使 用 实际 的 例子 来 创建 Intent, 使 用 显 式 和 隐 式 Intent 激活 其 他 组 件 ,加 深 
对 Intent 组 件 的 理解 ,了 解 如 何 利 用 Intent 在 Activity 之 间 传递 数据 。 


5.1.4 使 用 Intent 实现 数据 传递 


使 用 Intent 实现 数据 传递 无 论 是 显 式 还 是 隐 式 ,都 需要 有 以 下 几 个 步 又: 

(1) 定义 传递 数据 的 Activity, 也 就 是 通过 布局 文件 设计 Activity 的 界面 ,并 创建 相 
互 转换 的 几 个 Activity, 它 们 之 间 需 要 数据 转换 或 需要 在 某 种 情况 下 进行 切换 。 

(2) 在 Activity 中 创建 Intent, 设 定 所 传递 元 素 的 值 , 即 需 传递 的 数据 ;或 者 设 定 所 要 
切换 的 Activity。 

(3) 声明 Activity 以 及 Intent Filter, 这 一 步 在 manifest. xml 中 声明 所 创建 的 
Activity, 并 且 根 据 显 式 还 是 隐 式 的 设置 设 定 相 应 的 Intent Filter, 

下 面 我 们 使 用 例子 说 明 Intent 如 何在 Activity 之 间 起 作用 。 

1. 使 用 显 式 定义 Intent 

使 用 显 式 定义 Intent, 实 现 About 对 话 框 功能 : 

。 在 主页 面 ,用 户 单 击 About 按钮 时 ,弹出 一 个 对 话 框 ,显示 有 关 移 动 电子 商务 平台 

的 信息 。 

。 在 About 对 话 框 中 , 单 击 OK 按钮 ,返回 主页 面 。 

下 面 先 给 出 关键 的 Intent 创建 代码 ,方便 在 完整 的 程序 代码 中 查看 。 这 里 直接 给 出 
了 Intent 的 组 件 名 称 。 


// 显 式 方式 声明 Intent, 直接 启动 Secondactivity 

Intent it=new Intent (MainActivity.this,SecondActivity.class); 
// 启 动 Activity 

startActivity (it); 


完成 这 个 功能 ,需要 几 个 步 又 : 

(1) 定义 主 Activity 的 布局 ,设置 一 个 显示 信息 的 文本 框 TextView 和 About 按钮 ， 
见 代码 5. 2。 

代码 5.2 explicit_intent_main_layout. xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" Ea 
<TextView 


android:layout_width="fill_parent" 
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(2) 定义 单 击 按钮 后 出 现 的 第 二 个 Activity 的 布局 ,设置 一 个 显示 信息 的 文本 框 
TextView 和 OK 按钮 , 见 代码 5. 3。 
代码 5.3 explicit_intent_second_layout. xml 





(3) 定义 主 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 方法 中 编写 
单 击 按钮 后 的 事件 处 理 代 码 , 见 代码 5. 4。 
代码 5.4 ExplicitMainActivity. java 
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(4) 定义 第 二 个 用 户 界面 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 
方法 中 编写 单 击 OK 按钮 后 的 返回 主 界面 的 事件 处 理 代码 , 见 代 码 5. 5。 
代码 5.5 ExplicitSecondActivity. java 
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Intent intent=new Intent (SecondActivity.this,MainActivity. 
class); 

// 启 动 Activity 

startActivity (intent); 


完成 上 述 四 步 后 ,在 AndroidManifest. xml 中 注册 ,运行 此 程序 ,可 以 看 到 通过 显 式 
Intent 的 作用 ,可 以 在 两 个 界面 之 间 跳 转 。 通 过 这 个 例子 可 以 看 出 ,所 谓 显 式 Intent, 就 
是 通过 创建 Intent 对 象 ,直接 告诉 系统 要 启动 哪 一 个 Activity 或 其 他 组 件 。 

2. 使 用 隐 式 定义 Intent 

在 上 面 的 例子 中 ,使 用 显 式 Intent 实现 了 界面 的 跳 转 。 下 面 尝试 使 用 隐 式 Intent 来 
实现 与 上 述 例子 同样 的 功能 ,学 习 Action 检测 的 使 用 

下 面 先 给 出 关键 的 Intent 创建 代码 ,方便 在 完整 的 程序 代码 中 查看 。 


// 实 例 化 Intent 

Intent it=new Intent (); 

// 设 置 Intent 的 Action 属性 一 一 自 定义 的 action 
it.setAction("com.android.activity.MY_ACTION"); 
// 启 动 Activity 

startActivity(it); 


在 Androidmanifest. xml 中 的 主 界面 声明 中 的 代码 如 下 : 


<activity android:name=".ImplicitSecondActivity"> 
<intent-filter> 
<action android:name="com.android.activity.MY_ACTION"/> 
<category android:name="android.intent.category.DEFAULT"/> 
</intent-filter> 


</activity> 


完成 这 个 功能 ,需要 几 个 步 又: 

(1) 定义 主 Activity 的 布局 ,设置 一 个 显示 信息 的 文本 框 TextView 和 About 按钮 ， 
见 代码 5. 2。 

(2) 定义 单 击 按钮 后 出 现 的 第 二 个 Activity 的 布局 ,设置 一 个 显示 信息 的 文本 框 
TextView 和 OK 钮 , 见 代码 5. 3。 

(3) 定义 主 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 方法 中 编写 
单 击 按 钮 后 的 事件 处 理 代码 ,创建 Intent 对 象 ,设置 Intent 对 象 的 Action 字段 的 值 为 
com. android. activity. MY_ACTION, 见 代码 5. 6。 
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代码 5.6 ImplicitMainActivity. java 





(4) 定义 第 二 个 用 户 界 面 Activity, 导 入 布局 资源 定义 的 界面 , 见 代 码 5.7。 
代码 5.7 ImplicitSecondActivity. java 
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setContentView(R.layout. implicit intent second layout); 
Il: 


3. 使 用 Intent 传递 和 获取 数据 

无 论 是 显 式 Intent 还 是 隐 式 Intent, 除 了 可 以 启动 和 激活 其 他 的 组 件 之 外 ,还 可 以 同 
时 携带 需要 传递 到 另 一 个 组 件 的 信息 ,如 在 一 个 Activity 中 提供 给 用 户 输入 界面 ,完成 的 
多 个 信息 输入 ,然后 启动 另 一 个 Activity, 在 第 二 个 Activity 上 进行 信息 的 处 理 和 输出 。 
要 实现 这 种 功能 ,可 以 在 第 一 个 Activity 创建 Intent 对 象 ,设置 Intent 的 启动 条 件 , 也 就 
是 设置 显 式 Intent 或 隐 式 Intent 的 过 滤 条 件 , 同 时 把 用 户 输入 的 信息 也 放 入 这 个 Intent, 
这 样 在 第 二 个 Activity 接收 这 个 Intent 时 ,就 可 以 从 Intent 对 象 中 读 出 用 户 输入 的 信息 
了 。 类 似 的 信息 可 以 在 Intent 对 象 的 Extra 字段 中 存储 。 

下 面 这 个 例子 实现 在 FirstActivity 和 SecondActivity 之 间 传 递 用 户 输入 信息 的 
功能 : 

。 在 主页 面 ,用 户 单 击 About 按钮 时 ,弹出 一 个 对 话 框 ,显示 有 关 移 动 电子 商务 平台 

的 信息 。 

。 在 About 对 话 框 中 , 单 击 OK 按钮 ,返回 主页 面 。 

代码 5. 8 给 出 Intent 对 象 设置 的 主要 代码 ,可 以 按照 前 面 隐 式 的 Intent 使 用 方式 来 
编写 布局 文件 和 完整 的 应 用 程序 。 

代码 5.8 Intent 传递 和 获取 数据 


FirstActivity: 
Intenti=newIntent (this,ActivitySecond.class); 
i.putExtra("Valuel","ThisvalueoneforActivityTwo"); 
i.putExtra("Value2","ThisvaluetwoActivityTwo"); 
startActivityForResult (i,REQUEST CODE); 


SecondActivity: 
Bundleextras=getIntent ().getExtras (); 
Stringvaluel=extras.getString("Valuel"); 


Stringvalue2=extras.getString("Value2"); 


4. 通过 Intent 启动 系统 应 用 Activity 

通过 Intent 不 仅 可 以 启动 本 项 目 中 的 应 用 程序 ,还 可 以 通过 不 同 的 设 定 ,启动 系统 
提供 的 应 用 程序 ,利用 系统 定义 的 功能 。 有 具体 的 启动 和 激活 方式 ,可 以 使 用 显 式 Intent, 
也 可 以 使 用 隐 式 Intent 的 Action、Category 和 Data 的 任意 一 种 过 滤 条 件 设置 。 

例如 ,在 下 面 的 代码 中 定义 了 一 个 URI, 并 把 这 个 URI 作为 新 创建 的 Intent 对 象 的 
Data ,并 将 Intent 的 Action 设置 为 ACTION_VIEW。 通过 这 样 的 设置 ,当前 的 Activity 
发 送出 这 个 Intent 之 后 ,就 可 以 启动 系统 的 浏览 器 ,并 通过 浏览 器 打开 http://open. 
taobao. com 这 个 链接 的 网 页 。 
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下 面 的 例子 中 定义 了 一 个 单 选 列表 界面 ,简单 调用 浏览 器 .电话 拨号 日历 等 系统 应 
用 程序 。 通 过 这 个 例子 ,可 以 了 解 如 何 利 用 Intent 启动 和 激活 常用 的 系统 应 用 程序 。 

首先 定义 应 用 程序 的 界面 布局 ( 见 代 码 5. 9), 然 后 创建 用 户 界面 Activity( 见 代 
码 5.10) 。 

代码 5.9 to_system_intent _layout. xml 
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代码 5.10 ToSystemActivity. java 
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if (intent !=nul1) { 
startActivity(intent); 
) 
J 


@override 
public void onActivityResult (int requestCode, int resultCode, Intent 
data) ( 
if(resultCode==Activity.RESULT OK && requestCode==0) ( 
String result=data.toURI(); 
Toast.makeText (this, result, Toast.LENGTH_LONG) ; 


) 


前 面 只 列 出 了 主要 的 布局 文件 代码 和 Activity 定义 的 代码 ,如 果 要 使 程序 顺利 、 正 常 
执行 ,还 需要 定义 字符 串 等 资源 ,Activity 也 需要 在 AndroidMenifest. xml 文件 中 注册 。 

通过 前 面 的 例子 ,我 们 讨论 了 如 何 运 用 Intent 对 象 启动 和 激活 其 他 的 组 件 , 如 何在 
组 件 之 间 发 送 和 接收 消息 。 在 应 用 程序 设计 中 ,可 以 根据 需要 灵活 运用 Intent 的 各 种 
功能 。 


5.2 BroadcastReceiver 组 件 


5.2.1 BroadcastReceiver 的 概念 


Broadcast 是 一 种 广泛 运用 的 在 应 用 程序 之 间 传 输 信息 的 机 制 。BroadcastReceiver 
是 Android 系统 中 负责 接收 广播 消息 并 对 消息 做 出 反应 的 组 件 。 可 以 将 
BroadcastReceiver 理解 为 广播 接收 者 ,用 于 接收 程序 所 发 出 的 承载 各 种 各 样 广播 消息 的 
Intent。 它 在 本 质 上 相当 于 一 个 监听 器 ,监听 接收 广播 消息 ,然后 再 做 出 处 理 。 广 播 消息 
既 可 以 是 系统 发 送 , 也 可 以 由 用 户 应 用 程序 产生 。 

多 数 的 广播 是 系统 发 送 的 ,如 地 域 变换 .电量 不 足 , 来 电 来 信 等 。 程 序 也 可 以 播放 一 
个 广播 。BroadcastReceiver 没有 用 户 界面 ,可 以 接收 到 信息 后 启动 Activity 或 者 通过 
notificationManger 通知 用 户 ,也 可 以 通过 其 他 多 种 方式 通知 用 户 , 例 如 开启 背景 灯 、 振 动 
设备 .播放 声音 等 ,最 典型 的 是 在 状态 栏 显示 一 个 图 标 ,这 样 用 户 就 可 以 单 击 它 打开 看 通 
知 内 容 。 

如 果 是 用 户 应 用 程序 发 送 广 播 消息 ,在 Intent 对 象 创建 后 ,启动 BroadcastRecevicer 
的 方式 有 两 种 : 通过 sendBroadcast() 方 法 启动 和 通过 sendOrderedBroadcast() 方 法 启 
动 。 这 两 者 的 区 别 就 是 前 者 是 发 送 一 个 普通 的 广播 ,后 者 是 发 送 一 个 有 序 的 广播 。 

BroadcastReceiver 在 Android 应 用 程序 中 , 与 其 他 三 大 组 件 Activity、Service 和 
ContentProvider 一 样 ,是 以 一 段 独立 的 Java 程序 代码 存在 于 应 用 程序 项 目 中 ,如 果 要 在 
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程序 中 能 够 启动 和 运行 ,必须 要 在 Android 项 目 中 注册 。 

注册 BroadcastReceiver 有 两 种 方式 : 静态 注册 和 动态 注册 。 

静态 注册 : 在 AndroidManifest. xml 中 用 标签 声明 注册 ,并 在 标签 内 用 标签 设置 过 
滤器 。 例 如 ,静态 注册 命名 为 myRecevicer 的 BroadcastReceiver 的 代码 如 下 : 


<receiver android:name="myRecevicer"> 
<intent-filter> 
<action android:name="com.dragon.net"></action> 
</intent-filter> 


</receiver> 


除 上 述 静 态 的 注册 方式 之 外 ,BroadcastReceiver 也 可 以 通过 动态 的 方式 注册 ,通过 
Context. registerReceiver() 方法 来 实现 。 动 态 实现 注册 的 类 必须 是 BroadcastReceiver 
的 子 类 。 对 应 于 静态 注册 例子 的 动态 代码 如 下 : 


IntentFilter intentFilter=new IntentFilter(); 
intentFilter.addAction (String); 
registerReceiver (BroadcastReceiver,intentFilter); 


如 果 要 使 用 BroadcastReceiver 的 功能 ,首先 在 需要 发 送信 息 的 地 方 创建 Intent 对 象 ， 
把 要 携带 的 信息 和 用 于 过 滤 的 信息 载 人 Intent 对 象 中 ,然后 通过 调用 sendOrderBroadcast() 
或 sendStickyBroadcast() 方 法 ,把 Intent 对 象 以 广播 方式 发 送出 去 。 

当 Intent 发 送 以 后 ,所 有 已 经 注册 的 BroadcastReceiver 会 检查 注册 时 的 Intent 
Filter 是 否 与 发 送 的 Intent 相 匹配 , 若 匹 配 则 就 会 调用 BroadcastReceiver 的 onReceive() 
方法 。 所 以 当 我 们 定义 一 个 BroadcastReceiver 的 时 候 , 都 需要 实现 onReceive() 方 法 。 

Android 系统 中 定义 了 很 多 标准 的 Broadcast Action 来 响应 系统 的 广播 事件 , 见 
表 5.1。 需 要 的 话 ,这 些 Action 可 以 在 应 用 程序 中 直接 赋 给 Intent 的 Action 字段 。 

下 面 我 们 分 别 通 过 简单 的 例子 来 学 习 在 应 用 程序 中 其 他 组 件 如 何 创建 和 使 用 
Broadcast 消息 ,如 何 使 用 不 同 的 注册 方式 来 设置 BroadcastReceiver 的 过 滤 条 件 、 处 理 广 
播 信息 ,如 何 使 用 BroadcastReceiver 来 处 理 系 统 广播 信息 。 
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BroadcastReceiver 在 AndroidManifest. xml 文件 中 进行 静态 注册 ,使 用 二 application 二 
元 素 TICK < receiver > H WME (EJH h) BroadcastReceiver, 并 在 一 receiver 二 的 子 元 素 
<<intentrfilter 之 中 定义 过 滤 条 件 ,确定 接收 处 理 哪 一 类 的 Intent, 

如 果 BroadcastReceiver 采用 静态 方式 注册 ,无论 该 项 目的 应 用 程序 是 否 处 于 活动 状 
态 ,都 会 进行 监听 。 如 某 个 程序 设 定 监听 电池 使 用 情况 的 BroadcastReceiver, 当 程序 在 手 
机 上 安装 好 后 ,不管 这 个 应 用 程序 处 于 什么 状态 , 当 收 到 系统 广播 的 或 其 他 应 用 程序 广播 
的 有 关 电 池 使 用 状况 的 的 内 容 , 都 会 执行 其 onReceive() 中 的 内 容 。 

下 面 的 例子 定义 了 一 个 BroadcastReceiver, 当 其 接收 到 一 个 广播 消息 , 即 应 用 程序 发 
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送出 的 一 个 广播 Intent, 它 的 Action 字段 是 RECEIVER_ACTION 时 ,对 这 个 广播 消息 
有 件 进行 处 理 ,在 其 onRecieve() 方 法 中 把 这 个 Intent 的 有 关 信 息 写 人 日 志 。 
要 实现 这 个 例子 的 功能 ,需要 做 一 些 工作 : 
(1) 定义 发 送 广 播 Intent 的 界面 ,包括 布局 文件 main. xml 和 Activity。 
(2) 定义 BroadcastReceiver, 处 理 广播 消息 。 
(3) 在 AndroidManifest. xml 中 注册 所 定义 rn 
的 Broadcast Receiver, 定 义 其 过 滤器 。 
首先 定义 用 户 发 送 广播 界面 的 布局 文件 
main. xml( 见 代码 5. 11) ,在 界面 上 定义 一 个 按 
钮 ,使 其 显示 出 如 图 5. 1 所 示 的 界面 。 图 5.1 发 送 Broadcast 界面 
代码 5.11 main. xml 
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<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns :android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 


> 

<Button 
android:id="@+id/btnBroadcast" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text=" 发 送 Broadcast" 
/> 

</LinearLayout> 


图 5. 1 所 示 的 界面 是 这 个 例子 的 用 户主 界面 ,其 中 的 按钮 用 于 控制 广播 消息 Intent 
的 创建 和 发 送 。 在 定义 界面 的 Activity 中 导入 布局 文件 后 ,在 按钮 事件 处 理 代 码 中 创建 
一 个 Intent, 进 行 Action 设置 ,并 使 用 sendBroadcast() 发 送 这 个 Intent, 产 生 一 个 广播 消 
息 , 见 代码 5. 12。 

代码 5.12 TestStaticReceiverActivity. java 


import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 


import android.widget.Button; 


public class TestStaticReceiverActivity extends Activity{ 
// 定 义 action 常量 
protected static final String ACTION="com.android.broadcast.RECEIVER _ 
ACTION"; 
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完成 创建 和 发 送 广播 消息 的 功能 之 后 ,需要 定义 一 个 BroadcastReceiver 来 处 理 所 发 
送 的 广播 消息 ,实现 广播 日 志 的 填写 。 

定义 一 个 MyReceiver 类 ,继承 于 BroadcastReceiver, 覆 盖 onReceive() 方 法 ,在 其 中 
实现 写 日 志 操作 , 见 代 码 5. 13。 

代码 5. 13 MyReceiver. java 





定义 创建 广播 消息 的 Activity 和 处 理 广 播 消息 的 BroadcastReceiver 之 后 ,就 可 以 完 





`e 基于 Androd 平台 的 移动 互联 网 应 用 开发 (21) 


成 在 AndroidManifest. xml 配置 文件 中 的 静态 注册 了 。 

在 AndroidManifest. xml 文件 的 一 application 过 元 素 下 ,声明 TestBroadcastActivity 
和 MyReceiver。 在 MyReceiver 的 二 intent-filter 之 中 设 定 "com. android. broadcast. 
RECEIVER_ACTION" 为 符合 接收 条 件 action 字段 的 值 , 见 代码 5. 14。 

代码 5.14 AndroidManifest. xml 配置 文件 





执行 应 用 程序 , 单 击 用 户主 界面 图 5. 1 中 的 按钮 ,程序 会 调用 MyReceiver 中 的 
onReceive() 方 法 ,LogCat 输出 信息 见 图 5. 2。 





Time j pid tag Message 





09-01 13:17... I 863 Test MyReceiver onReceive-—> 





图 5.2 logCat 输出 信息 


5.2.3 动态 注册 方式 
BroadcastReceiver 的 动态 注册 方式 采用 在 Java 程序 代码 中 调用 Activity 的 方法 来 
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注册 。 因 为 是 在 程序 运行 过 程 中 才 注册 ,所 以 称 为 动态 注册 。 注 册 时 ,所 需要 信息 同样 包 
括 Receiver 和 Intent Filter, 以 及 Action 的 条 件 。 
动态 注册 方式 与 静态 注册 方式 不 同 ,因为 在 





程序 运行 中 注册 ,所 以 当 应 用 程序 关闭 后 ， — 
Receiver 就 不 再 进行 监听 。 
下 面 这 个 例子 通过 按钮 事件 ,在 Java 程序 中 Mt 
动态 实现 BroadcastReceiver 的 注册 和 注销 , 见 注销 广播 接听 器 
图 5.3。 
要 实现 这 个 例子 的 功能 ,需要 做 下 面 工作 : 图 5.3 动态 实现 BroadcastReceiver 
(1) 定义 具有 三 个 按钮 的 用 户 界面 的 布局 文 的 注册 和 注销 界面 


件 main. xml 和 相关 的 资源 文件 ,代码 略 。 

(2) 定义 用 户 界面 的 Activity, 导 入 布局 文件 ,并 根据 按钮 不 同 的 功能 ,在 按钮 单 击 事 
件 处 理 代码 中 实现 不 同 的 功能 , 见 代码 5. 15。 

(3) 定义 BroadcastReceiver, 处 理 广播 消息 , 见 代码 5. 16。 

(4) 在 AndroidManifest. xml 中 注册 所 定义 的 Activity 和 BroadcastReceiver。 

代码 5.15 TestDynamicRecieverActivity. java 


import android.app.Activity; 

import android.content.Intent; 

import android.content.IntentFilter; 
import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 


import android.widget.Button; 


public class TestDynamicRecieverActivity extends Activity{ 

// 定 义 action 常量 

protected static final String ACTION="com.android.broadcast.RECEIVER_ 

ACTION"; 

private Button btnBroadcast; 

private Button registerReceiver; 

private Button unregisterReceiver; 

private MyReceiver receiver; 

@override 

public void onCreate (Bundle savedInstanceState)( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


// 创 建 Intent 发 送 广播 消息 
btnBroadcast= (Button) findViewById(R.id.btnBroadcast); 
btnBroadcast.setOnClickListener (new OnClickListener(){ 
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代码 5.16 MyReceiver. java 
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public void onReceive (Context context, Intent intent){ 
// 输 出 日 志 信息 


Log .i (TAG, "MyReceiver onReceive--->"); 


ji 


Java 程序 代码 编写 完成 后 ,不 要 忘记 还 需要 在 AndroidMenifest. xml 文件 中 注册 才 
能 够 运行 。 执 行 前 面 的 代码 ,出现 用 户 界面 后 ,我 们 可 以 分 步 测试 ,观察 结果 日 志 , 了 解 动 
态 注册 对 Receiver 功能 的 影响 。 

(1) 首先 单 击 “ 发 送 广 播 ” 按 钮 的 时 候 ,因为 程序 没有 注册 BraodcastReceiver, 所 以 
MyReceiver 不 会 监听 处 理 任何 广播 信息 ,LogCat 没有 输出 任何 信息 。 

(2) 单 击 “ 注 册 广 播 接 收 器 ”按钮 ,程序 会 执行 此 按钮 事件 处 理 代码 ,动态 地 注册 
BraodcastReceiver; 再 单 击 “ 发 送 广 播 ” 按 钮 , MyReceiver 会 监听 系统 中 的 广播 Intent, 并 
检测 是 否 与 注册 的 过 滤 条 件 匹 配 , 这 里 发 送 的 Intent 的 Action 字段 的 值 与 动态 注册 的 
Intent Filter 条 件 相同 ,系统 会 调用 其 onReceive() 方 法 处 理 这 个 广播 消息 , 则 LogCat 会 
增添 新 的 日 志 信息 。 

G) 单 击 “ 注 销 广 播 监听 器 ”按钮 ,程序 会 执行 此 按钮 事件 处 理 代码 ,动态 地 注销 
BraodcastReceiver, MyReceiver 恢复 到 没有 注册 时 的 情况 ;再 单 击 “发 送 广播 > 按钮 ， 
LogCat 没有 输出 任何 信息 。 


5.3 Notification 管理 


Notification, 即 通知 ,是 一 种 消息 ,可 以 在 应 用 程序 界面 显示 其 图 形 标记 ,提示 用 户 。 
例如 当 用 户 操 作 应 用 时 ,如 果 有 电话 .短信 或 者 邮件 到 达 , 可 以 向 系统 提交 一 个 
Notification, 它 会 首先 以 图 标的 形式 显示 在 设备 的 状态 栏 位 置 , 在 手机 的 状态 栏 上 就 会 
出 现 一 个 小 图 标 , 提示 用 户 处 理 这 个 消息 ,如 图 5.4 所 示 。 用 户 手 从 上 方 滑动 状态 栏 就 可 
以 展开 查看 通知 的 详细 信息 ,并 进行 处 理 。 

通知 的 详细 信息 展开 后 的 显示 元 素 如 图 5.5 所 示 。 


图 5.4 提示 图 标 图 5.5 Notification 详细 信息 





对 应 图 中 的 标号 ,元 素 分 别 为 : 
。1: 通知 的 标题 ; 

。 2: 大 图 标 ; 

。 3: 通知 的 内 容 ; 
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。4: 通知 的 信息 ; 

° 5: 小 图 标 ; 

° 6: 通知 发 送 的 时 间 。 

Android 提供 了 两 种 类 型 的 Notification 视图 : 正常 视图 (Normal View) 和 大 视图 
(Big View) ,图 5. 5 是 正常 的 视图 。 还 有 一 种 是 大 视图 ,除了 正常 视图 的 元 素 之 外 ,还 包 
括 消息 的 细节 内 容 。 消 息 细节 内 容 的 图 形 显示 样式 可 以 设置 为 不 同 的 样式 ,包括 大 图 样 
式 、 大 文本 样式 \ 收 件 箱 样 式 等 。 这 些 样 式 上 还 包括 一 些 正 常 视图 上 没有 的 界面 元 素 。 


5.3.1 创建 Notification 


Notification 与 Toast 都 可 以 起 到 通知 、 提 醒 的 作用 ,都 可 以 随时 取消 。 但 它们 的 实 
现 原理 和 表现 形式 却 完全 不 一 样 。Toast 相当 于 一 个 定时 关闭 的 对 话 框 , 是 用 户 界面 某 
个 Activity 的 一 部 分 ,也 可 以 用 弹出 的 方式 对 用 户 的 某 个 操作 给 出 简单 的 反馈 。 
Notification 显示 在 屏幕 上 方 的 状态 栏 中 ,在 用 户 界面 之 外 ,也 可 以 有 闪烁 声音 、 震 动 等 
其 他 形式 ,是 相对 独立 的 。 更 重要 的 是 ,使 用 和 查看 Notification 通常 会 对 系统 的 任务 栈 
产生 影响 ,需要 用 NotificationManager 来 管理 ,而 对 于 Toast, 只 需要 简单 地 创建 对 象 并 
显示 ,不 会 对 系统 产生 影响 。 

Android 系统 的 NotificationCompat. Builder 类 用 于 创建 Notification 对 象 。 在 应 用 
需要 时 ,可 以 使 用 Notification. Builder. build() 方 法 来 创建 一 个 Notification 对 象 ,并 同时 
设置 其 界面 显示 图 标 和 动作 。 

NotificationManager 类 用 于 管理 Notification 对 象 。 使 用 NotificationManager. 
notify() 可 以 将 创建 后 的 Notification 对 象 向 系统 发 布 出 去 ,在 状态 栏 中 显示 出 来 。 

在 一 个 Notification 对 象 中 ,小 图 标 、 标 题 和 文本 内 容 三 个 字段 是 必须 赋值 的 。 

在 创建 Notification 对 象 时 ,可 以 由 Notification. Builder. build() 方 法 直接 给 这 三 个 
字段 赋值 ,也 可 以 在 创建 完成 后 使 用 setSmallIcon ( ) 方法 、setContentTitle() 方法 和 
setContentText() 方 法 分 别 进行 设置 。 其 他 的 字段 都 是 可 选 的 。 具体 字段 的 细节 ,可 以 
查阅 Notification. Builder 类 的 说 明 。 

虽然 其 他 字段 都 是 可 选 的 ,但 一 般 来 说 ,每 个 Notification 至 少 还 是 会 设置 一 个 动作 
Action。 例 如 用 户 在 单 击 或 触发 Notification 时 ,可 以 打开 一 个 Activity, 或 者 关闭 闹钟 ， 
或 者 打开 一 个 浏览 器 等 。 一 个 Notification 可 以 定义 多 个 动作 ,在 其 被 单 击 时 同时 触发 。 

Notification 对 象 中 所 设 定 的 动作 , 是 通过 PendingIntent 对 象 来 定义 的 。 
PendingIntent 对 象 中 包含 一 个 Intent, 可 以 用 来 启动 一 个 Activity。 通 过 Notification. 
Builder 中 的 setContentIntent() 方 法 来 将 一 个 PendingIntent 对 象 与 一 种 操作 关联 起 来 。 

创建 和 发 布 一 个 简单 的 Notification 分 下 面 几 个 步 又 。 

A) 创建 一 个 Notification 对 象 。 

在 创建 一 个 Notification 对 象 时 ,需要 通过 Notification. Builder 定义 Notification 定 
义 它 的 小 图 标 、 标 题 和 文本 内 容 。 代 码 如 下 : 
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NotificationCompat.Builder mBuilder= 
new NotificationCompat.Builder(this) 
.setSmallIcon (R.drawable.notification_ icon) 
.SetContentTitle ("My notification") 
.SetContentText "Hello World!"); 


(2) 定义 Notification 的 Action 动作 。 

一 般 来 说 ,每 个 Notification 至 少 会 设置 一 个 动作 Action, 通 过 这 个 Action 启动 其 他 
的 Activity, 让 用 户 进 入 应 用 程序 的 另 一 个 用 户 界面 ,查看 引起 这 个 Notification 的 事件 
或 做 进一步 处 理 。 

Notification 的 动作 定义 通过 PendingIntent 对 象 完 成 。 具 体 代码 实现 时 首先 创建 一 
个 Intent 对 象 ,设置 在 Notification 操作 时 要 启动 的 Activity; 然 后 创建 一 个 这 个 Intent 
对 象 的 PendingIntent 对 象 ,具体 如 何 构建 PendingIntent 对 象 与 启动 的 Activity 类 型 
有 关 。 

下 面 是 简单 的 代码 : 


Intent resultIntent=new Intent (this, ResultActivity.class); 


PendingIntent resultPendingIntent= 
PendingIntent.getActivity( 
this, 
0, 
resultIntent, 
PendingIntent .FLRAG UPDATE CURRENT 
); 


(3) 设置 Notification 的 单 击 行为 。 

如 果 要 把 上 面 定 义 的 PendingIntent 对 象 与 一 个 用 户 操作 相关 联 ,需要 调用 
NotificationCompat. Builder 的 对 应 方法 。 例 如 , 当 用 户 单 击 通知 Notification 的 文本 时 ， 
要 启动 一 个 Activity, 则 通过 setContentIntent() 方 法 添加 前 面 定义 的 PendingIntent 对 
象 。 代 码 如 下 : 


mBuilder.setContentIntent (resultPendingIntent); 


简单 地 说 ,PendingIntent 就 是 在 Intent 上 加 了 指定 的 动作 。 对 于 Intent 来 说 ,只 有 
在 执行 startActivity() ,startService() 或 sendBroadcast() 方 法 后 ,才能 使 Intent 有 用 ;而 
对 于 PendingIntent 来 说 ,本 身 就 包含 了 这 些 方法 的 功能 ,还 可 以 使 用 PendingIntent. 
getActivity() 和 PendingIntent. getService() 方 法 来 调用 活动 和 服务 。 例 如 : 


PendingIntent pi=PendingIntent.getActivity (this, 0, new Intent (this, 
HandleNotificationActivity.class), 0) 
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PendingIntent 还 有 PendingIntent. getBroadcast() 方 法 ,其 包含 了 sendBroadcast() 
的 功能 

(4) 发 布 一 个 Notification 。 

发 布 Notification 时 ,首先 要 获取 一 个 NotificationManager 实例 ,使 用 notify() 方 法 
发 布 Notification 对 象 ,然后 使 用 buildO 〇 返回 一 个 Notification 对 象 。 


//Sets an ID for the notification 
int mNotificationId=001; 
//Gets an instance of the NotificationManager service 
NotificationManager mNotifyMgr= 

(NotificationManager) getSystemService (NOTIFICATION SERVICE); 
//Builds the notification and issues it 
mNotifyMgr.notify(mNotificationId, mBuilder.build()); 


到 此 为 止 ,创建 一 个 简单 的 Notification 的 代码 就 完成 了 。 

下 面 通过 一 个 简单 的 例子 ,说 明 如 何在 应 用 程序 中 创建 和 使 用 Notification。 在 这 个 
例子 中 , 主 界 面 是 一 个 Button, 单 击 Button 后 创建 一 个 简单 的 Notification, 这 个 
Notification 的 具体 内 容 由 另 一 个 Activity 显示 。 

首先 ,在 SampleofAndroid 项 目 中 定义 主 界面 的 布局 文件 ,说 明 主 界面 中 的 Button 
单 击 后 的 事件 处 理 代 码 由 createNotification() 方 法 实现 , 见 代 码 5. 17。 

代码 5.17 simple_notif_layout. xml 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match Parent" 


android:orientation="vertical"> 


<Button 
android:id="@+id/button" 
android:layout width="match parent" 
android:layout height="match parent" 
android:onClick="createNotification" 
android:text="Create Notification"> 
</Button> 


</LinearLayout> 


然后 ,定义 Notification 内 容 的 查看 界面 的 布局 文件 , 见 代码 5. 18。 
代码 5.18 simple_notif_result_layout. xml 


<?xm1 version="1.0" encoding="utf-8"?> 
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创建 展示 Notification 内 容 的 Activity, 见 代码 5.19, 
代码 5.19 NotificationResultActivity. java 





创建 主 界面 的 Activity, 在 其 中 实现 Button 单 击 事件 处 理 器 createNotification() 方 
法 ,在 其 中 创建 Notification , 见 代 码 5. 20。 
代码 5.20 CreateNotificationActivity. java 
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Emih Notification 的 例子 是 最 简单 的 Notification 格式 ,如 果 要 向 通知 添加 声音 、 闪 
灯 和 振动 效果 ,最 简单 .最 一 致 的 方式 是 使 用 当前 的 用 户 默 认 设置 ,使 用 Notification 的 
defaults 属性 。 这 些 属性 可 以 组 合 使 用 。 例 如 : 





如 果 想 全 部 使 用 默认 值 ,可 以 使 用 Notification. DEFAULT_ALL 常量 。 


通过 向 sound 属性 分 配 一 个 位 置 URI, Android 可 以 将 手机 上 的 任意 音频 文件 作为 
通知 进行 播放 。 
下 面 给 出 一 些 Notification 提示 方式 的 不 同 设置 的 例子 。 
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(1) 在 状态 栏 (Status Bar) 显 示 的 通知 文本 提示 ,代码 如 下 : 
notification.tickerText="hello"; 


(2) 发 出 提示 音 ,代码 如 下 : 


notification.defaults=Notification.DEFAULT SOUND; 
notification.sound=Uri.parse ("file:///sample/notification/ringer .mp3"); 
notification.sound= Uri.withAppendedPath (Audio.Media. INTERNAL CONTENT _ 
URI, "6"); 


(3) 手机 振动 ,代码 如 下 : 
notification.defaults=Notification.DEFAULT VIBRATE; 


long[] vibrate={0, 100,200,300}; 
notification.vibrate=vibrate; 


(4) LED 灯 闪 烁 ,代码 如 下 : 


notification.defaults=Notification.DEFAULT LIGHTS; 


// 或 者 可 以 自己 的 LED 提醒 模式 
notification.ledARGB=0xff00ff00; 
notification. ledOnMS=300; // 亮 的 时 间 
notification.ledOffMS=1000; // 灭 的 时 间 


notification.flags=Notification.FLAG SHOW LIGHTS; 


532 ”导航 设计 


应 用 程序 创建 完 Notification 后 , Notification 会 在 某 个 条 件 满足 时 被 发 布 ,这 时 在 用 
户 界 面 上 方 的 状态 栏 中 会 出 现 一 个 图 标 。 例 如 ,用 户 在 玩 游戏 的 时 候 收 到 了 一 封 Email, 
邮件 到 达 的 Notification 就 会 显示 在 状态 栏 中 。 用 户 可 以 在 任意 时 候 滑动 图 标 打开 
Notification ,查看 其 内 容 。 

当 用 户 从 某 个 应 用 程序 界面 去 查看 一 个 Notification 时 ,需要 离开 当前 的 Activity, 
离开 当前 的 应 用 程序 流程 ,由 Notification 的 PendingIntent 去 启动 另 一 个 Activity, 来 展 
示 Notification 的 内 容 。 这 个 Activity 可 能 是 另 一 个 应 用 程序 正常 流程 中 的 一 个 界面 ,也 
可 能 仅仅 是 一 个 独立 的 显示 界面 。 如 果 不 做 任何 设置 , 当 用 户 浏 览 完 Notification 按 
Backspace 键 时 ,无 论 前 面 的 那 种 情况 ,用 户 界 面 会 回 到 查看 Notification 之 前 的 界面 。 
如 果 希 望 针 对 这 两 种 情况 做 不 同 的 处 理 , 在 设计 Notification 时 可 以 根据 情况 采用 不 同 的 
Activity 启动 方式 。 

Notification 有 两 种 常用 的 Activity 启动 方式 : 有 规律 的 Activity 和 特定 的 Activity。 

如 果 Notification 启动 的 Activity 是 一 个 应 用 程序 正常 流程 的 一 部 分 , 则 这 个 需 启 动 
的 Activity 归 为 有 规律 的 Activity。 在 这 种 情况 下 ,可 以 创建 一 个 PendingIntent 来 启动 
一 个 新 任务 , 即 启动 一 个 新 的 应 用 程序 ,并 且 给 PendingIntent 建立 一 个 回 退 栈 ,这 个 回 退 
栈 中 复制 了 这 个 程序 流程 中 按 Backspace 键 程序 做 出 的 正常 反应 行为 。 
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例如 ,Gmail 邮件 的 Notification 示范 了 这 类 固定 的 Activity, 当 用 户 单 击 一 个 邮件 的 
Notification 时 ,用 户 可 以 看 到 信息 ;而 使 用 Backspace 键 后 ,用 户 会 回 到 Gmail 收 件 箱 的 
Activiy。 如 果 用 户 继续 使 用 Backspace 键 , 则 回 到 Home 界面 上 ,这 就 像 从 Home 界面 进 
A Gmail 应 用 效果 一 样 。 

这 种 情况 的 设置 ,通过 Notification 进入 一 个 应 用 程序 后 ,会 按照 这 个 应 用 程序 的 流 
程 正常 运行 ,与 用 户 直 接 运 行 这 个 应 用 程序 功能 相同 。 如 果 用 户 持 续 按 Backspace 键 或 
直接 按 Home 键 ,最 后 会 回 到 Home 界面 上 ,而 不 是 最 初 查看 Notification 的 应 用 程序 
界面 。 

如 果 从 Notification 启动 的 Activity 并 不 是 某 个 应 用 程序 流程 的 一 部 分 ,而 是 为 了 显 
示 Notification 很 难 显 示 的 信息 或 更 细节 的 信息 而 创建 的 用 户 界面 ,是 Notification 的 一 
个 扩展 , 则 将 这 个 Activity 定义 为 特定 的 Activity。 这 种 情况 下 ,不 需要 创建 回 退 栈 , 如 
果 使 用 Backspace 键 , 会 直接 回 到 Home 界面 。 

(1) 为 有 规律 的 Activity 创建 PendingIntent。 

首先 ,在 Manifest 文件 中 定义 应 用 程序 的 Activity 层次 结构 。 

对 于 Android 4. 0. 3 和 之 前 的 版 本 ,通过 在 一 activity 二 元 素 中 增加 二 meta-data 二 子 
元 素来 指定 Activity 的 父 级 。 在 这 个 子 元 素 中 ,设置 android: name = "android. support. 
PARENT_ACTIVITY" 和 android: value= "< parent_activity_name>", J£ rR < parent_ 
activity_name> Œ t4 47 <activity > JEZ fJ # FR o 

对 于 Android 4. 1 和 之 后 的 版 本 ,通过 为 二 activity > Jú # P JL android; 
parentActivityName 属性 来 设置 , 见 代 码 5.21。 

代码 5.21 Manifest 中 定义 Activity 层次 结构 


<activity 
android:name=".MainActivity" 
android:label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity 
android:name=".ResultActivity" 
android:parentActivityName=".MainActivity"> 
<meta-data 
android:name="android.support.PARENT ACTIVITY" 
android:value=".MainActivity"/> 
</activity> 


其 次 ,基于 启动 Activity 的 Intent 创建 回 退 栈 。 创 建 回 退 栈 需要 完成 下 面 几 个 设置 : 
O 创建 启动 Activity 的 Intent, 
© 调用 TaskStackBuilder. create() 创 建 栈 创建 器 。 
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© 调用 addParentStack() 把 回 退 栈 加 入 栈 中 ,对 于 定义 在 manifest 层次 中 的 每 一 个 
Activity, 回 退 栈 中 都 包含 一 个 启动 其 的 Intent 对 象 。 
@ 调用 addNextIntent() 添 加 从 Notification 中 启动 Activity 的 Intent, 把 前 面 所 创 
建 的 Intent 作为 参数 。 
O 如 果 需 要 给 栈 中 的 Intent 对 象 添 加 参数 ,可 以 调用 TaskStackBuilder. 
editIntentAt() ,这 可 以 保证 让 用 户 在 使 用 Backspace 键 导航 时 ,确保 目标 Activity 显示 有 
效 的 数据 。 
调用 calling getPendingIntent() 方 法 从 回 退 栈 中 获取 一 个 PendingIntent, 然 后 把 
这 个 PendingIntent 作为 setContentIntent() 方 法 的 参数 。 
具体 的 设置 过 程 可 以 参考 代码 5. 22, 
代码 5.22 创建 回 退 栈 


Intent resultIntent=new Intent (this, ResultActivity.class); 
TaskStackBuilder stackBuilder=TaskStackBuilder.create(this); 
//adds the back stack 
stackBuilder.addParentStack(ResultActivity.class); 
//adds the Intent to the top of the stack 
stackBuilder.addNextIntent (resultIntent) 7 
//Gets a PendingIntent containing the entire back stack 
PendingIntent resultPendingIntent= 
stackBuilder.getPendingIntent (0, PendingIntent.FLAG_UPDATE CURRENT); 


NotificationCompat.Builder builder=new NotificationCompat.Builder(this); 
builder.setContentIntent (resultPendingIntent); 
NotificationManager mNotificationManager= 

(NotificationManager) getSystemService (Context .NOTIFICATION SERVICE); 
mNotificationManager.notify(id, builder.build()); 


(2) 使 用 特定 的 Activity, 

如 果 使 用 特定 的 Activity, 就 不 需要 使 用 回 退 栈 , 也 不 需要 在 Manifest 中 定义 
Activity 的 层次 结构 等 ,而 是 需要 设置 Activity 的 任务 选项 ,并 且 使 用 getActivity() 方 法 
创建 PendingIntent。 

首先 在 Manifest 文件 中 添加 "android: taskAffinity" 和 "android: excludeFromRecents" 
这 两 个 <activity 二 的 属性 的 设置 , 见 代 码 5. 23。 

代码 5.23 Manifest 说 明 特定 的 Activity 属性 


<activity 
android:name=".ResultActivity" 


android:launchMode="singleTask" 
android:taskAffinity="" 
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android:excludeFromRecents="true"> 


</activity> 


其 次 ,建立 和 发 布 Notification , 见 代码 5. 24. 

O 创建 启动 Activity 的 Intent, 

@ 通 过 调用 setFlags() 设 置 新 的 空 任务 ,把 FLAG_ACTIVITY_NEW_TASK 和 
FLAG_ACTIVITY_CLEAR_TASK 作为 标记 参数 。 

@ 设置 Intent 的 其 他 需要 的 选项 。 

@ 通过 调用 getActivity() 方 法 使 用 Intent 创建 一 个 PendingIntent 对 象 , 然 后 把 这 
个 PendingIntent 作为 setContentIntent() 方 法 的 参数 。 

代码 5.24 建立 和 发 布 Not 


























ication 


//Instantiate a Builder object. 
NotificationCompat .Builder builder=new NotificationCompat.Builder (this); 
//Creates an Intent for the Activity 
Intent notifyIntent= 
new Intent (new ComponentName (this, ResultActivity.class)); 
//Sets the Activity to start ina new, empty task 
notifyIntent.setFlags (FLAG ACTIVITY NEW TASK | FLAG ACTIVITY CLEAR TASK); 
//Creates the PendingIntent 
PendingIntent notifyIntent= 
PendingIntent.getActivity( 
this, 
0, 
notifyIntent 
PendingIntent.FLAG_ UPDATE CURRENT 
); 


//Puts the PendingIntent into the notification builder 
builder.setContentIntent (notifyIntent); 
//Notifications are issued by sending them to the 
//NotificationManager system service. 
NotificationManager mNotificationManager= 

(NotificationManager) getSystemService (Context .NOTIFICATION SERVICE); 
//Builds an anonymous Notification object from the builder, and 
//passes it to the NotificationManager 
mNotificationManager.notify(id, builder.build()); 


Notification 通过 有 规律 的 Activity 启动 方式 和 特定 的 Activity 启动 方式 ,都 可 以 使 
用 户 在 查看 Notification 之 后 ,通过 Backspace 键 和 Home 键 回 到 Home 界面 。 如 果 创 建 
Notification 时 不 做 任何 设置 ,如 同 5. 3. 1 的 例子 一 样 , 则 Backspace 键 会 使 用 户 界面 回 
到 查看 Notification 之 前 的 界面 。 
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Android 4.1 对 Android 的 Notification 框架 进行 了 重大 的 更 新 。 应 用 程序 现在 可 以 
通过 单 击 选 择 展 开 或 者 折 和 三 来 显示 更 大 、 更 丰富 的 Notification, Notification 支持 包括 
照片 在 内 的 新 内 容 类 型 ,支持 优先 级 的 配置 , 以 及 多 个 动作 的 设置 。 使 用 改进 的 
Notification ,应 用 程序 可 以 创建 的 使 用 面积 较 大 ,高 达 256dp 的 高 度 的 Notification 
信息 。 

Android 系统 提供 的 Notification 主要 包括 以 下 四 种 类 型 。 

。 基本 类 型 ,其 使 用 图 标 显示 简单 的 、 短 的 通知 信息 。 

。 大 图 片 类 型 (Big Picture Style) ,其 可 以 显示 图 片 的 内 容 , 例 如 位 图 。 

。 大 文本 类 型 (Big Text Style) ,其 可 以 显示 多 个 TextView。 

。 收 件 箱 类 型 (Inbox Style) ,其 可 以 显示 任何 类 型 的 列表 。 

我 们 前 面 的 例子 都 是 创建 的 基本 类 型 的 Notification。 基 本 类 型 Notification 呈现 的 
是 正常 视图 (Normal View) ,而 后 面 三 种 类 型 的 Notification 都 属于 大 视图 (Big View) 模 
式 。 下 面 简 单 介 绍 大 视图 模式 的 Notification 如 何 创 建 。 

在 Android 4. 1 之 前 的 版 本 中 ,需要 程序 员 直 接 创建 Notification 对 象 ,而 Android 
4.1 之 后 的 版 本 可 以 使 用 Notification. Builder 类 来 创建 Notification 对 象 , 简化 了 
Notification 对 象 创建 的 过 程 ,而 且 可 以 根据 需求 ,使 用 Notification. BigPictureStyle、 
Notification. BigTextStyle 和 Notification. InboxStyle 工具 类 ,创建 各 种 类 型 的 通知 。 下 
面 是 如 何 创建 大 视图 模式 Notification 的 三 种 样式 的 代码 示范 。 

(1) 大 文本 类 型 。 


Builder builder=new Notification.Builder (this); 
builder.setContentTitle ("Big text Notofication") 

.SetContentText ("Big text Notification") 

.SetSmallIcon (R.drawable.ic launcher) 

.SetAutoCancel (true); 

.SetPriority (Notification.PRIORITY HIGH) 

.addAction(R.drawable.ic launcher web, "show activity", pi); 
Notification notification=new Notification.BigTextStyle (builder) 

.bigText (msgText) .build() 


(2) 大 图 片 类 型 。 


Builder builder=new Notification.Builder(this); 
builder.setContentTitle("BP notification") 
//Notification title 
.SetContentText ("BigPicutre notification") 
//you can put subject line. 
.setSmallIcon (R.drawable.ic launcher) 
//Set your notification icon here. 
.addAction(R.drawable.ic launcher web, "show activity", pi) 
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.addAction( 
R.drawable.ic launcher share, 
"Share", 
PendingIntent.getActivity(getApplicationContext(), 0, 
getIntent (), 0, null)); 


//Now create the Big picture notification. 
Notification notification=new Notification.BigPictureStyle (builder) 
.bigPicture( 
BitmapFactory.decodeResource (getResources (), 
R.drawable.big_picture)).build(); 
//Put the auto cancel notification flag 
notification.flags |=Notification.FLAG AUTO CANCEL; 


(3) 收 件 箱 类 型 。 


Builder builder=new Notification.Builder (this) 
.SetContentTitle("IS Notification") 
.SetContentText ("Inbox Style notification!!") 
.setSmallIcon (R.drawable.ic launcher) 


.addAction (R.drawable.ic launcher web, "show activity", pi); 


Notification notification=new Notification.InboxStyle (builder) 
.addLine ("First message") .addLine ("Second message") 
.addLine ("Thrid message") .addLine ("Fourth Message") 
.SetSummaryText ("+2 more") .build (); 

//Put the auto cancel notification flag 

notification.flags |=Notification.FLAG_AUTO_CANCEL; 


在 Notification 的 样式 设置 完成 后 ,创建 Notification 的 其 余 步 又 与 基本 样式 类 似 。 


5.4 本 章 小 结 


本 章 主要 介绍 了 Android 系统 中 用 于 消息 传递 的 组 件 Intent, BroadcastReciever 和 
Notification 。 

Intent 是 Android 的 一 个 基础 组 件 。 通 过 Intent 的 消息 创建 ,消息 触发 消息 传递 和 
消息 响应 ,Android 系统 实现 窗口 跳 转 、 传 递 数据 或 调用 外 部 程序 ,进行 应 用 程序 的 激活 
和 调用 。Android 的 三 大 基础 组 件 Activity、Service、BroadcastReceiver, 都 可 以 通过 定义 
Intent 的 消息 ,实现 在 各 组 件 之 间 的 程序 跳 转 和 数据 传递 。Intent 对 象 中 同时 携带 触发 
其 他 组 件 执行 的 条 件 信息 和 触发 后 该 组 件 执行 时 所 需要 的 信息 。 

使 用 Intent 来 实现 程序 跳 转 和 数据 传递 有 两 种 不 同方 式 : 显 式 和 隐 式 。 在 Intent 对 
象 的 组 件 名 称 属 性 Component Name 里 直接 设 定 要 激活 的 组 件 , 这 种 方式 称 为 显 式 ; 
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Activity、Service、BroadcastReceiver 可 以 在 Manifest 文件 中 ,通过 Intent 过 滤器 设置 一 
个 或 多 个 条 件 ,说 明 该 组 件 可 接收 的 Intent 对 象 , 过 滤 掉 不 想 接收 的 隐 式 Intent 对 象 ,这 
种 方式 称 为 隐 式 。 

BroadcastReceiver 是 Android 系统 中 负责 接收 广播 消息 并 对 消息 做 出 反应 的 组 件 。 
BroadcastReceiver 没有 用 户 界 面 , 可 以 接收 到 信息 后 启动 Activity 或 者 通过 
NotificationManger 通知 用 户 ,也 可 以 通过 其 他 多 种 方式 通知 用 户 。 多 数 的 广播 是 系统 
发 起 ,如 果 是 用 户 应 用 程序 发 送 广播 消息 ,在 Intent 对 象 创建 后 ,启动 BroadcastRecevicer 
的 方式 有 两 种 : sendBroadcast() 方 法 和 sendOrderedBroadcast() 方 法 。 

Notification, 即 通知 ,是 一 种 消息 ,以 图 标的 形式 显示 在 设备 的 状态 栏 位 置 ,提示 用 
户 。Android 提供 了 两 种 类 型 的 Notification 视图 : 正常 视图 (Normal View) 和 大 视图 
(Big View)。Android 系统 的 NotificationCompat. Builder 类 用 于 创建 Notification 对 
象 。 在 应 用 需要 时 ,可 以 使 用 Notification. Builder. build() 方 法 来 创建 一 个 Notification 
对 象 , 并 同时 设置 其 界面 显示 图 标 和 动作 。 
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6.1 基本 概念 


在 Android 系统 中 ,如 果 有 一 个 应 用 程序 组 件 是 第 一 次 被 启动 ,而 且 这 时 候 应 用 程序 
也 没有 其 他 组 件 在 运行 , 则 Android 系统 会 为 应 用 程序 创建 一 个 Linux 进程 ,这 个 Linux 
进程 只 包含 一 个 线程 。 举 个 例子 ,如 果 一 个 应 用 程序 启动 了 第 一 个 Activity, 这 个 
Activity 里 有 一 个 文本 框 和 一 个 按钮 ,这 时 ,Android 系统 会 为 应 用 程序 创建 一 个 单线 程 
的 Linux 进程 ,初始 化 这 个 文本 框 和 按钮 , 当 这 个 应 用 程序 启动 另 一 个 Activity 时 ,初始 
化 图 形 组 件 的 还 是 这 个 已 经 创建 好 的 线程 ,不 会 再 创建 新 的 。 也 就 是 说 ,这 个 应 用 程序 会 
一 直 单线 程 单 任务 运行 图 形 组 件 的 初始 化 和 与 图 形 组 件 相关 的 操作 。 

默认 情况 下 ,同一 个 应 用 程序 的 所 有 组 件 都 运行 在 同一 个 进程 和 线程 里 ,这 个 线程 叫 
做 主线 程 。 如 果 一 个 组 件 启动 时 ,应 用 程序 的 其 他 组 件 已 经 在 运行 了 , 则 此 组 件 会 在 已 有 
的 进程 和 线程 中 启动 运行 。 

如 果 希 望 Android 应 用 程序 实现 多 任务 ,可 以 通过 代码 指定 组 件 运行 在 其 他 进程 里 ， 
或 为 进程 创建 额外 的 线程 。 

下 面 介 绍 Android 的 进程 调度 机 制 。 


6.1.1 进程 


默认 情况 下 ,同一 个 应 用 程序 内 的 所 有 组 件 都 是 运行 在 同一 个 进程 中 的 ,大 部 分 应 用 
程序 都 是 按照 这 种 方式 运行 的 。 但 在 具体 应 用 中 ,很 多 时 候 需 要 通过 在 Manifest 文件 中 
进行 设置 ,指定 某 个 特定 组 件 归 属于 哪个 进程 。 

可 以 通过 manifest. xml 文件 设 定 应 用 程序 归属 的 进程 。Manifest 文件 中 的 每 种 组 
件 元 素 一 一 二 activity >, < service >, < receiver > 和 < provider 二 一 一 都 支持 定义 
android: process 属性 ,用 于 指定 组 件 运行 的 进程 。 

设置 这 个 属性 就 可 实现 每 个 组 件 在 各 自 的 进程 中 运行 ,或 者 某 几 个 组 件 共 享 一 个 进 
程 而 其 他 组 件 运行 于 独立 的 进程 。 设 置 这 个 属性 也 可 以 让 不 同 应 用 程序 的 组 件 运行 在 同 
一 个 进程 中 ,这 就 实现 了 多 个 应 用 程序 共享 同一 个 Linux 用 户 ID 赋予 同样 的 权限 。 

<application > Jú # tB 3 # android: process 属性 ,用 于 指定 所 有 组 件 的 默认 进程 。 

Android 一 个 重要 并 且 特 殊 的 特性 就 是 ,一 个 应 用 的 进程 的 生命 周期 不 是 由 应 用 程 
序 自身 直接 控制 的 ,而 是 由 系统 根据 运行 中 的 应 用 的 一 些 特征 来 决定 的 ,包括 这 些 应 用 程 
序 对 用 户 的 重要 性 、 系 统 的 全 部 可 用 内 存 。 
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大 部 分 情况 下 ,每 个 Android 应 用 程序 都 将 运行 在 自己 的 Linux 进程 当中 。 当 这 个 
应 用 的 某 些 代码 需要 执行 时 ,进程 就 会 被 创建 ,并 且 将 保持 运行 ,直到 该 进程 不 再 需要 ,而 
系统 需要 释放 它 所 占用 的 内 存 ,为 其 他 应 用 所 用 时 才 停 止 。 

Android 系统 试图 尽 可 能 长 时 间 地 保持 应 用 程序 进程 ,但 为 了 新 建 或 者 运行 更 加 重 
要 的 进程 ,总 是 需要 清除 过 时 进程 来 回收 内 存 。 为 了 决定 保留 或 终止 哪个 进程 ,根据 进程 
内 运行 的 组 件 及 这 些 组 件 的 状态 ,系统 把 每 个 进程 都 划 入 一 个 “重要 性 层次 结构 ”中 。 重 
要 性 最 低 的 进程 首先 会 被 清除 ,然后 是 下 一 个 最 低 的 , 依 此 类 推 , 这 都 是 回收 系统 资源 所 
必需 的 。 

重要 性 层次 结构 共有 五 级 ,按照 重要 程度 列 出 了 各 类 进程 : 前 台 进 程 \. 可 见 进程 、 服 
务 进 程 \ 后 台 进 程 和 空 进程 ,其 中 第 一 类 进程 是 最 重要 的 ,将 最 后 一 个 被 终止 。 

1. 前 台 进 程 

用 户 当 前 操作 所 必须 的 进程 。 满 足以 下 任 一 条 件 时 ,进程 被 视 作 处 于 前 台 : 

。 正在 与 用 户 交互 的 Activity 进程 (例如 Activity 的 onResume() 方 法 已 被 调用 ) 。 

。 正在 与 用 户 交互 的 Activity 绑 定 的 Service 进程 。 

。 正在 运行 前 台 Service 进程 ,例如 Service 被 startForeground() 方 法 调用 。 
正在 运行 生命 周期 回调 方法 (例如 onCreate ©) , onStart () 或 onDestroy()) 的 
Service, 

。 正在 运行 onReceive() 方 法 的 BroadcastReceiver。 

一 般 而 言 ,任何 时 刻 只 有 很 少 的 前 台 进 程 同 时 运行 。 只 有 当 内 存 不 足以 维持 它们 同 
时 运行 时 ,作为 最 后 的 策略 它们 才 会 被 终止 。 通 常 , 终 止 一 些 前 台 进 程 是 为 了 保证 用 户 界 
面 的 及 时 响应 。 

2. 可 见 进 程 

如 果 进 程 没有 任何 前 台 组 件 但 仍 会 影响 用 户 在 屏幕 上 所 见 内 容 的 进程 , 称 为 可 见 进 
程 。 满 足以 下 任 一 条 件 时 ,进程 被 认为 是 可 见 的 : 

。 如 果 Activity 不 在 前 台 , 但 用 户 仍然 可 见 ( 例 如 Activity 的 onPause() 方 法 被 调用 

了 )。 如 当前 台 Activity 打开 了 一 个 对 话 框 , 而 之 前 的 Activity 还 允许 显示 在 后 
面 , 但 是 已 经 无 法 与 用 户 进 行 交 互 了 。 

。 一 个 绑 定 到 可 见 或 前 台 Activity 的 Service 进程 。 

可 见 进程 被 认为 是 非常 重要 的 ,除非 无 法 维持 所 有 前 台 进 程 同时 运行 了 ,和 否则 它们 是 
不 会 被 终止 的 。 

3. 服务 进程 

对 于 由 startService() 方 法 启动 的 Service 进程 , 它 不 会 升级 为 上 述 两 种 级 别 。 尽 管 
服务 进程 不 直接 和 用 户 所 见 内 容 关联 ,但 它们 通常 在 执行 一 些 用 户 关心 的 操作 ,如 在 后 台 
播放 音乐 或 从 网 络 下 载 数据 等 。 因 此 ,除非 内 存 不 足以 维持 所 有 前 台 、 可 见 进 程 同时 运 
行 ,系统 会 保持 服务 进程 的 运行 。 

4. 后 台 进 程 

后 台 进程 包含 目前 用 户 不 可 见 Activity( 例 如 Activity 的 onStop() 方 法 已 被 调用 ) 的 
进程 。 这 些 进程 对 用 户 体验 没有 直接 的 影响 ,系统 可 能 在 任意 时 间 终 止 它们 ,以 回收 内 存 


so 
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供 前 台 进程 可 见 进程 及 服务 进程 使 用 。 通 常会 有 很 多 后 台 进 程 在 运行 ,所 以 它们 被 保存 
在 一 个 LRU( 最 近 最 少 使 用 ) 列 表 中 ,以 确保 最 近 被 用 户 使 用 的 Activity 最 后 一 个 被 终 
止 。 如 果 一 个 Activity 正确 实现 了 生命 周期 方法 ,并 保存 了 当前 的 状态 , 则 终止 此 类 进程 
不 会 对 用 户 体验 产生 可 见 的 影响 。 因 为 在 用 户 返 回 时 ,Activity 会 恢复 所 有 可 见 的 状态 。 
如 果 要 了 解 关 于 保存 和 恢复 状态 的 详细 信息 ,可 以 参阅 Activity 生命 周期 文档 。 

5. 空 进程 

空 进程 即 不 含 任何 活动 应 用 程序 组 件 的 进程 。 保 留 这 种 进程 的 唯一 目的 就 是 用 作 组 
存 , 以 改善 下 次 在 此 进程 中 运行 组 件 的 启动 时 间 。 为 了 在 进程 缓存 和 内 核 缓存 间 平 衡 系 
统 整体 资源 ,系统 经 常会 终止 这 种 进程 。 

依据 进程 中 目前 活跃 组 件 的 重要 程度 ,Android 会 给 进程 评估 一 个 尽 可 能 高 的 级 别 。 
例如 : 如 果 一 个 进程 中 运行 着 一 个 服务 和 一 个 用 户 可 见 的 Activity, 则 此 进程 会 被 评定 为 
可 见 进 程 , 而 不 是 服务 进程 。 

此 外 ,一 个 进程 的 级 别 可 能 会 由 于 其 他 进程 的 依赖 而 被 提高 ,为 其 他 进程 提供 服务 的 
进程 级 别 永远 不 会 低 于 使 用 此 服务 的 进程 。 

因为 运行 服务 的 进程 级 别 是 高 于 后 台 Activity 进程 的 ,所 以 ,如 果 Activity 需要 启动 
一 个 长 时 间 运 行 的 操作 , 则 为 其 启动 一 个 服务 Service 会 比 简单 地 创建 一 个 工作 线程 更 好 
些 ,尤其 是 在 此 操作 时 间 比 Activity 本 身 存在 时 间 还 要 长 久 的 情况 下 。 


6.1.2 线程 


应 用 程序 启动 时 ,系统 会 为 它 创建 一 个 名 为 main 的 主线 程 。 主 线程 非常 重要 ,因为 
它 负责 把 事件 分 发 给 相应 的 用 户 界面 widget 一 一 包括 屏幕 绘图 事件 。 它 也 是 应 用 程序 
与 Android UI 组 件 包 ( 来 自 android. widget 和 android. view 包 ) 进 行 交互 的 线程 。 因 此 ， 
主线 程 有 时 也 被 叫做 UI 线程 。 

系统 并 不 会 为 每 个 组 件 的 实例 都 创建 单独 的 线程 。 运 行 于 同一 个 进程 中 的 所 有 组 件 
都 是 在 UI 线程 中 实例 化 的 ,对 每 个 组 件 的 系统 调用 也 都 是 由 UI 线 程 分 发 的 。 

如 果 应 用 程序 在 与 用 户 交 互 的 同时 需要 执行 繁重 的 任务 ,用 户 单线 程 模式 可 能 会 导 
致 运行 性 能 很 低下 。 例 如 ,在 查询 数据 库 时 ,应 用 程序 就 需要 做 两 件 事 , 一 是 需要 与 数据 
库 连 接 ,访问 数据 库 ,获取 查询 结果 ;二 是 要 初始 化 显示 界面 的 组 件 ,把 获取 的 数据 给 显示 
出 来 。 因 为 是 单线 程 ,就 必须 先 做 完 第 一 件 事后 才能 做 第 二 件 事 。 这 个 过 程 有 可 能 因为 
网 络 状况 或 数据 库 繁 忙 ,在 访问 数据 库 、 获 取 结 果 数 据 时 花费 比较 长 的 时 间 , 导 致 不 能 执 
行 用 户 显示 界面 的 初始 化 ,使 得 用 户 界 面 呈 现 出 静止 状态 。 这 种 状态 , 称 为 UI 线程 阻 
塞 。 如 果 UI 线程 被 阻塞 超过 一 定时 间 ( 目 前 大 


SampleMcommerce is not 约 是 5 秒 钟 ) ,就 会 弹出 对 话 框 ,提示 用 户 应 用 程 
Qi di 9 m = 1 . 7N Mì 

ASNE 序 没有 响应 (ANR) 。 图 6. 1 就 是 这 个 对 话 框 。 

Would you like to close it? Android 的 单线 程 模式 遵守 两 个 规则 : 不 要 


阻塞 UI 线程 和 不 要 在 UI 线程 之 外 访问 
Android 的 UI 组 件 包 。 
图 6.1 UI 线程 阻塞 提示 对 话 框 这 样 ,程序 才能 有 友好 的 界面 ,顺利 运行 。 


Wait OK 
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一 般 稍 微 复杂 一 点 的 应 用 程序 ,特别 是 需要 网 络 访问 或 数据 库 访问 的 应 用 程序 ,都 需要 使 
用 多 任务 的 方式 。 

在 Android 应 用 程序 中 ,我 们 创建 的 Activity, Service, Broadcast 等 都 是 在 主线 程 
(UI 线程 ) 处 理 的 ,但 一 些 比较 耗 时 的 操作 ,如 I/O 读 写 的 大 文件 读 写 ,进行 数据 库 操作 以 
及 网 络 下 载 需要 很 长 时 间 , 为 了 不 阻塞 用 户 界面 ,会 出 现 响 应 提示 窗口 ,这 时 我 们 可 以 考 
虑 创建 一 个 工作 线程 (继承 Thread 类 或 者 实现 Runnable 接口 ) 来 解决 。 


6.2 实现 多 任务 


Android 多 任务 的 调度 和 实现 采用 消息 驱动 机 制 。 熟 悉 Windows 编程 的 朋友 可 能 
知道 Windows 程序 是 消息 驱动 的 ,并 且 有 全 局 的 消息 循环 系统 。 而 Android 应 用 程序 也 
是 消息 驱动 的 , Google 参考 了 Windows 系统 ,也 在 Android 系统 中 实现 了 消息 循环 机 
制 。Android 通过 Looper, Handler, MessageQueue 和 Message 来 实现 消息 循环 机 制 ， 
Android 消息 循环 是 针对 线程 的 , 即 主 线程 和 工作 线程 都 可 以 有 自己 的 消息 队列 和 消息 
循环 。 


6.2.1 多 任务 实现 原理 


对 于 多 线程 的 Android 应 用 程序 来 说 ,有 两 类 线程 : 一 类 是 主线 程 ,也 就 是 UI 线程 ; 
另 一 类 是 工作 线程 ,也 就 是 主线 程 或 工作 线程 所 创建 的 线程 。Android 的 线程 间 消 息 处 
理 机 制 主要 是 用 来 处 理 主线 程 跟 工作 线程 间 通 信 的 。 图 6. 2 是 线程 间 通信 原理 图 。 
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图 6.2 线程 间 通信 原理 


Android 应 用 程序 是 通过 消息 来 驱动 的 , 即 在 应 用 程序 的 主线 程 (UI 线程) 中 有 一 个 
消息 循环 ,负责 处 理 消息 队列 中 的 消息 。 

例如 , 当 从 网 上 下 载 文件 时 ,为 了 不 使 主线 程 被 阻塞 ,通常 需要 创建 一 个 子 线程 来 负 
责 下 载 任 务 ,同时 ,在 下 载 的 过 程 中 ,将 下 载 进度 以 百分比 的 形式 在 应 用 程序 的 界面 上 显 
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示 出 来 ,这 样 既 不 会 阻塞 主线 程 的 运行 ,又 能 获得 良好 的 用 户 体 验 。 但 是 ,Android 应 上 
程序 的 子 线程 是 不 可 以 操作 主线 程 的 UI 的 ,那么 ,这 个 负责 下 载 任务 的 子 线程 应 该 如 何 
在 应 用 程序 界面 上 显示 下 载 的 进度 呢 ? 如 果 我 们 能 够 在 子 线程 中 往 主 线程 的 消息 队列 中 
发 送 消息 ,那么 问题 就 迎刃而解 了 ,因为 发 往 主 线程 消息 队列 的 消息 最 终 是 由 主线 程 来 处 
理 的 ,在 处 理 这 个 消息 时 ,就 可 以 在 应 用 程序 界面 上 显示 下 载 进度 了 。 

线程 之 间 和 进程 之 间 是 不 能 直接 传递 消息 的 ,必须 通过 对 消息 队列 和 消息 循环 的 操 
作 来 完成 。Android 消息 循环 是 针对 线程 的 ,每 个 线程 都 可 以 有 自己 的 消息 队列 和 消息 
循环 。Andriod 提供 了 Handler 类 和 Looper 类 来 访问 消息 队列 (Message Queue), 

Looper 类 是 用 来 封装 消息 循环 和 消息 队列 的 一 个 类 ,负责 管理 线程 的 消息 队列 和 消 
息 循环 ,用 于 在 Android 线程 中 进行 消息 处 理 。Looper 对 象 是 什么 呢 ? 其实 Android 中 
每 一 个 线程 都 对 应 一 个 Looper, Looper 可 以 帮助 线程 维护 一 个 消息 队列 ,是 负责 在 多 线 
程 之 间 传 递 消息 的 一 个 循环 器 ,线程 通过 Looper 对 象 可 以 读 写 某 个 消息 循环 队列 。 使 用 
Looper. myLooper() 得 到 当前 线程 的 Looper 对 象 ,使 用 Looper. getMainLooper() 可 以 
获得 当前 进程 的 主线 程 的 Looper 对 象 。 

一 个 线程 可 以 存在 也 可 以 不 存在 一 个 消息 队列 和 一 个 消息 循环 ,工作 线程 默认 是 没 
有 消息 循环 和 消息 队列 的 。 如 果 想 让 工作 线程 具有 消息 队列 和 消息 循环 ,需要 在 线程 中 
首先 调用 Looper. prepare() 来 创建 消息 队列 ,然后 调用 Looper. loop() 进 入 消息 循环 , 见 
代码 6. 1。 

代码 6.1 CustomThread. java 





class CustomThread extends Thread { 
@Override 
public void run() { 
// 建 立 消息 循环 的 步骤 
//1. 初始 化 Looper 
Looper.prepare(); 
//2. Æ handler 到 customThread 实例 的 Looper 对 象 
mHandler=new Handler() { 
//3. 定义 处 理 消息 的 方法 
public void handleMessage (Message msg) { 
Switch (msg.what) { 
case MSG_HELLO: 
Log.d("Test", "CustomThread receive msg:" 


+ (String) msg.obj); 


) 
b; 
//4. 启动 消息 循环 


Looper .loop(); 
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通过 代码 6.1 的 设置 ,工作 线程 CustomThread 就 具有 了 消息 队列 和 消息 循环 的 处 
理 机 制 ,可 以 在 Handler 中 进行 消息 处 理 。 代 码 中 定义 的 Handler 对 象 , 其 作用 是 把 消息 
加 入 特定 的 消息 队列 中 ,并 分 发 和 处 理 该 消息 队列 中 的 消息 。 

每 个 Activity 是 一 个 UI 线程 ,运行 于 主线 程 中 。Android 系统 在 启动 的 时 候 会 为 
Activity 创建 一 个 消息 队列 和 消息 循环 。 

— Activity 中 可 以 创建 多 个 工作 线程 或 者 其 他 的 组 件 , 如 果 这 些 线程 或 者 组 件 把 
它们 的 消息 放 入 Activity 的 主线 程 消息 队列 ,那么 该 消息 就 会 在 主线 程 中 处 理 了 。 因 为 
主线 程 一 般 负责 界面 的 更 新 操作 ,并且 Android 系统 中 的 界面 控件 都 是 单线 程 模式 ,多 线 
程控 制 需 要 程序 员 实现 , 也 就 是 非 线程 安全 的 ,所 以 这 种 方式 可 以 很 好 地 实现 Android 界 
面 更 新 。 在 Android 系统 中 这 种 机 制 有 广泛 的 应 用 。 

那么 一 个 工作 线程 怎样 把 消息 放 和 人 主线 程 的 消息 队列 呢 ? 答案 是 通过 Handle 对 
象 。 只 要 Handler 对 象 由 主线 程 的 Looper 创建 ,那么 调用 Handler 的 sendMessage() 等 
方法 ,就 会 把 消息 放 和 人 主线 程 的 消息 队列 ;在 主线 程 中 调用 Handle 的 handleMessage() 
方法 来 处 理 消息 ,在 这 个 方法 中 实现 主线 程 的 界面 控件 的 操作 ,从 而 实现 了 工作 线程 和 主 
线程 之 间 的 调度 。 

下 面 是 一 个 简单 的 例子 ,在 Activity 中 定义 了 Handler 对 象 h, 并 定义 了 一 个 工作 进 
程 MyThread, 在 工作 进程 中 使 用 对 象 h 的 sendMessage() 发 送 了 一 条 消息 到 主线 程 的 消 
息 队列 , 见 代 码 6. 2。 

代码 6.2 MyHandler. java 


public class MyHandler extends Activity { 
static final String TAG="Handler"; 
static final int HANDLER_TEST=1; 
Handler h=new Handler () { 
public void handleMessage (Message msg) { 
switch (msg .what) { 
case HANDLER_TEST: 
Log.d(TAG, "The handler thread id=" 
+Thread.currentThread().getId()+" "); 


break; 


); 


/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
Log.d(TAG, "The main thread id="+Thread.currentThread().getId() 
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new myThread () .start () 
setContentView (R.layout.main); 
1 


class MyThread extends Thread { 
public void run() ( 
Message msg=new Message () ; 
msg.what=HANDLER_TEST; 
h.sendMessage (msg) ; 
Log.d (TAG, "The worker thread id=" 
+Thread.currentThread().getId()+" "); 


) 


编译 运行 代码 6. 2 后 ,可 以 看 到 有 三 条 打印 信息 ,显示 了 在 这 个 Activity 运行 过 程 
中 ,各 个 模块 所 处 的 线程 情况 。 

在 这 个 例子 中 ,主线 程 在 onCreate() 方 法 中 通过 new myThread(). start() 启 动 了 工 
作 线 程 ,工作 线程 MyThread 中 run( ) 方 法 中 的 执行 代码 ,访问 了 主线 程 Handler 对 象 h， 
并 在 调用 Handler 的 对 象 h 时 ,向 主线 程 消息 队列 加 入 了 一 条 消息 。 这 个 过 程 中 会 不 会 
出 现 消 息 队 列 数据 不 一 致 问 题 呢 ? 因为 Handler 对 象 管理 的 Looper 对 象 是 线程 安全 的 ， 
不 管 是 加 入 消息 到 消息 队列 和 从 队列 读 出 消息 都 是 有 同步 对 象 保护 的 ,Handler 对 象 不 
会 出 问题 。 由 于 这 里 没有 修改 Handler 对 象 ,因此 Handler 对 象 不 可 能 会 出 现 数据 不 一 
致 的 问题 。 

工作 线程 和 主线 程 运行 在 不 同 的 线程 中 ,所 以 必须 要 注意 这 两 个 线程 间 的 竞争 关系 。 
在 主线 程 中 构造 Handler 对 象 ,并 且 启 动工 作 线程 之 后 不 要 再 修改 ,否则 会 出 现 数 据 不 一 
致 。 这 样 在 工作 线程 中 可 以 放心 地 调用 SendMessage() 等 方法 传递 消息 ,Handler 对 象 
的 handleMessage() 方 法 将 会 在 主线 程 中 调用 。 在 这 个 方法 可 以 安全 的 调用 主线 程 中 任 
何 变 量 和 函数 ,进而 完成 更 新 UI 的 任务 。 

Android 有 两 种 方式 实现 多 线程 操作 UI: 第 一 种 是 创建 新 线程 Thread, 用 Handler 
负责 线程 间 的 通信 和 消息 。 第 二 种 方式 AsyncTask 异步 执行 任务 。 

下 面 如 何 使 用 Handle 实现 多 任务 。 


6.2.2 用 Handler 实 现 多 任务 


android. os. Handler 是 Android SDK 中 处 理 定时 操作 的 核心 类 。 通 过 Handler 类 ， 
可 以 提交 和 处 理 一 个 Runnable 对 象 。 这 个 对 象 的 run() 方 法 可 以 立刻 执行 ,也 可 以 在 指 
定时 间 之 后 执行 (可 以 称 为 预约 执行 ) 。 

Handler 类 有 两 种 主要 用 途 : 按照 时 间 计 划 ,在 未 来 某 时 刻 , 对 处 理 一 个 消息 或 执行 
某 个 runnable 实例 。 把 一 个 对 另外 线程 对 象 的 操作 请 求 放 和 人 消息 队列 中 ,从 而 避免 线程 
间 冲 突 。 
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当 一 个 进程 启动 时 ,主线 程 独立 执行 一 个 消息 队列 ,该 队列 管理 着 应 用 顶层 的 对 象 
(如 Activity. BroadcastReceiver 等 ) 和 所 有 创建 的 窗口 。 可 以 创建 自己 的 一 个 线程 ,并 通 
过 Handler 来 与 主线 程 进行 通信 。 这 可 以 通过 在 新 的 线程 中 调用 主线 程 的 Handler 的 
postXXX 和 SendMessage() 方 法 来 实现 。 

使 用 post() 方 法 实现 多 任务 的 主要 步骤 如 下 : 

(1) 创建 一 个 Handler 对 象 。 

(2) 将 要 执行 的 操作 写 在 线程 对 象 的 run() 方 法 中 。 

(3) 使 用 post() 方 法 运行 线程 对 象 。 

(4) 如 果 需 要 循环 执行 ,需要 在 线程 对 象 的 run() 方 法 中 再 次 调用 post() 方 法 。 

相关 代码 见 代 码 6. 3。 

代码 6.3 HandlerActivity. java 
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6.2.3 AsyncTask 实现 多 任务 


用 Handler 类 来 在 子 线程 中 更 新 UI 线程 虽然 避免 了 在 主线 程 进行 耗 时 计算 ,但 费 
时 的 任务 操作 总 会 启动 一 些 匿名 的 子 线程 , 太 多 的 子 线程 给 系统 带 来 巨大 的 负担 , 随 之 带 
来 一 些 性 能 问题 。 因 此 , Android 提供 了 一 个 工具 类 AsyncTask 来 实现 异步 执行 任务 。 
AsyncTask 类 擅 于 处 理 一 些 后 台 比 较 耗 时 的 任务 ,给 用 户 带 来 良好 的 用 户 体验 ,不 再 需 
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要 子 线程 和 Handler 就 可 以 完成 异步 操作 并 且 刷 新 用 户 界 面 。 

如 果 要 使 用 AsyncTask, 需 要 创建 AsyncTask 类 ,并 实现 其 中 的 抽象 方法 以 及 重 写 
某 些 方法 。 利 用 AsyncTask 不 需要 自己 来 写 后 台 线 程 , 无须 终 结 后 台 线 程 ,但 是 
AsyncTask 的 方式 对 循环 调用 的 方式 并 不 太 合 适 。AsyncTask 是 抽象 类 ,AsyncTask E 
义 了 三 种 泛 型 : Params、Progress 和 Result。 它 们 的 含义 分 别 为 : 

。 Params: 表示 启动 任务 执行 的 输入 参数 ,如 HTTP 请 求 的 URL。 

。 Progress: 表示 后 台 任 务 执行 的 百分比 。 

。 Result: 表示 后 台 执 行 任 务 最 终 返回 的 结果 ,如 String ,Integer 等 。 

我 们 通过 继承 一 个 AsyncTask 类 来 定义 一 个 异步 任务 类 。Android 提供 一 个 让 程 
序 员 编 写 后 台 操作 更 为 容易 和 透明 AsyncTask, 使 得 后 台 线 程 能 够 在 UI 主线 程 外 进行 
处 理 。 

AsyncTask 实现 多 任务 ,实现 步骤 如 下 : 

(1) 使 用 execute() 方 法 触发 异步 任务 的 执行 。 

(2) 使 用 onPreExecute() 执 行 预 处 理 , 如 绘制 一 个 进度 条 控件 。 

(3) 使 用 doInBackground() 执 行 较为 费时 的 操作 ,这 个 方法 是 AsyncTask 的 关键 ， 
必须 覆盖 重 写 。 

(4) 使 用 onProgressUpdate() 对 进度 条 控件 根据 进度 值 做 出 具体 的 响应 。 

(5) 使 用 onPostExecute() 对 后 台 任 务 的 结果 做 出 处 理 。 

相关 代码 见 代 码 6. 4。 

代码 6.4 AsyncTaskActivity. java 


import android.app.Activity; 

import android.os.AsyncTask; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.ProgressBar; 

import android.widget.TextView; 


import com.taobao.mcommerce.sample.R; 


public class AsyncTaskActivity extends Activity implements 
OnClickListener { 

private Button Btn; 

private TextView txt; 

private int count=0; 

private boolean isRunning=false; 

private ProgressBar progressBar; 


/** Called when the activity is first created. */ 
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” 





progressBar .setProgress (progress[0]); 
} 


@Override 

protected void onPostExecute (String result) { 
super .onPostExecute (result); 
txt.setText (result); 


6.3 理解 服务 


Service 是 Android 的 四 大 组 件 之 一 ,用 于 支持 Android 系统 的 服务 。Service 是 一 个 
能 够 在 后 台 执行 长 时 间 运 行 的 操作 应 用 程序 组 件 , 不 提供 用 户 界面 。Android 的 其 他 应 
用 的 组 件 可 以 在 后 台 启 动 一 个 Service 运行 ,即使 用 户 切换 到 另 一 个 应 用 ,此 Service 也 会 
继续 运行 。Android 服务 组 件 就 像 是 Windows 系统 服务 或 者 UNIX 的 守护 进程 ,这 些 都 
是 在 后 台 运 行 而 不 可 见 。 

Service 不 能 与 用 户 交 互 ,也 不 能 自己 启动 ,需要 调用 Context, startService ( ) 或 
bindService() 来 启动 ,在 后 台 运 行 。 当 应 用 程序 需要 进行 某 种 不 在 前 台 显 示 的 计算 或 数 
据 处 理 时 ,就 可 以 启动 一 个 Service 来 完成 ,每 个 Service 都 继承 自 android. app 包 下 的 
Service 类 。 每 个 Service 都 必须 在 AndroidManifest. xml 中 通过 一 service 二 进行 声明 。 

Service 具有 自己 的 生命 周期 。Service 服务 的 生命 周期 是 与 Activity 生命 周期 分 离 
的 , 当 Activity 被 暂停 .停止 或 者 销毁 时 ,Service 组 件 还 可 以 继续 处 理 其 他 任务 。 例 如 ， 
一 个 服务 可 以 处 理 网 络 事务 .播放 音乐 、 执 行文 件 IO 或 者 跟 内 容 提 供 器 交互 ,所 有 这 些 
都 是 在 后 台 完 成 的 。 

Android 支持 服务 有 两 个 原因 : 一 是 允许 我 们 方便 地 执行 后 台 任务 ,二 是 实现 同一 
设备 上 应 用 之 间 的 跨 进程 通信 。 基 于 这 两 个 原因 ,Android 系统 支持 两 种 类 型 服务 ,分 别 
是 本 地 服务 和 远程 服务 。 本 地 服务 是 指 只 可 以 被 驻 留 服务 的 应 用 访问 的 服务 ,而 不 能 被 
本 设备 上 的 其 他 应 用 访问 ;远程 服务 既 可 以 被 其 所 驻 留 的 应 用 访问 ,也 可 以 被 设备 上 的 其 
他 应 用 访问 。 例 如 在 开发 一 个 邮件 应 用 时 ,可 以 创建 一 个 本 地 服务 实现 邮件 的 发 送 , 这 是 
由 于 邮件 的 发 送 需 要 网 络 连接 ,这 是 一 个 耗 时 操作 ,需要 在 后 台 执行 ;另外 一 种 情况 ,如 果 
一 个 设备 上 很 多 程序 都 需要 一 个 通用 的 翻译 功能 ,可 以 创建 一 个 远程 服务 实现 翻译 功能 ， 
而 不 是 在 每 个 应 用 中 都 实现 这 个 功能 。 

Android SDK 包括 了 Service 类 ,其 中 的 代码 封装 了 服务 的 行为 。 但 是 Service 与 上 
面 介绍 的 AsyncTask 不 同 ,一 个 Service 对 象 不 会 自动 创建 自己 的 线程 ,而 是 运行 在 服务 
的 宿主 进程 的 主线 程 中 。 这 就 意味 着 如 果 服 务 要 做 一 些 频繁 的 CPU 工作 (如 MP3 的 回 
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放 或 网 络 操作 ) 就 会 阻塞 主线 程 , 我 们 应 该 在 这 个 服务 中 创建 一 个 新 的 线程 来 做 这 项 工 
作 。 通 过 使 用 一 个 单独 的 线程 ,会 减少 应 用 程序 不 响应 (ANR) 的 错误 风险 ,并 且 应 用 程 
序 的 主线 程 能 够 保留 给 用 户 ,专用 于 跟 Activity 的 交互 。 

如 果 要 创建 一 个 服务 ,有 两 种 方式 : 启动 方式 (startService) ,通过 startService() 方 
法 启动 ; 绑 定 方式 (bindService) ,通过 bindService() 方 法 启动 。 

应 用 程序 组 件 可 以 通过 调用 Context. startService() 方 法 获得 服务 ,这 个 过 程 也 是 使 
服务 生效 的 过 程 ,例如 在 Activity 中 调用 startService() 方 法 。 可 以 通过 调用 Context. 
startService( ) 启 动 服务 ,然后 通过 调用 Context. stopService() 或 Service. stopSelf() 停 止 
服务 。 服 务 一 旦 启动 , 它 就 能 够 无 限期 地 在 后 台 运 行 ,即使 启动 它 的 组 件 被 销毁 。 通 常 ， 
一 个 被 启动 的 服务 只 有 一 个 单一 操作 ,并 且 不 给 调用 者 返回 结果 。 例 如 ,这 个 服务 可 能 在 
网 络 上 下 载 或 上 传 文件 。 当 操作 完成 时 ,服务 应 该 自己 终止 。 如 果 仅 以 启动 方式 使 用 的 
服务 ,这 个 服务 需要 具备 自 管理 的 能 力 , 且 不 需要 通过 方法 调用 向 外 部 组 件 提供 数据 或 
功能 。 

应 用 程序 组 件 也 可 以 通过 调用 bindService () 方 法 启动 和 绑 定 一 个 服务 ,通过 
ServiceConnection 或 直接 获取 服务 中 的 状态 和 数据 信息 , 例如 使 用 Activity 的 
bindService() 方 法 。 被 绑 定 的 服务 会 提供 一 个 允许 组 件 跟 服 务 交 互 的 客户 端 接口 ,用 于 
发 送 请 求 .获取 结果 ,其 至 是 跨 进程 的 进程 间 通 信 实 现 远程 服务 。 应 用 组 件 绑 定 服务 后 ， 
可 以 使 用 ServiceConnection 获取 服务 对 象 ,并 且 调 用 服务 中 的 方法 。 应 用 组 件 通过 
Context. bindService ( ) 方法 绑 定 服务 ,并 且 建 立 ServiceConnection; 通过 Context. 
unbindService() 方 法 解除 绑 定 ,并 且 停 止 ServiceConnection。 如 果 在 绑 定 过 程 中 服务 没 
有 启 动 , Context，bindService ( ) 会 自动 启动 服务 。 同 一 个 服务 可 以 绑 定 多 个 
ServiceConnection ,这 样 可 以 同时 为 多 个 不 同 的 组 件 提供 服务 。 一 个 被 绑 定 服务 的 运行 
时 间 与 绑 定 它 的 应 用 程序 组 件 一 样 长 。 多 个 组 件 能 够 绑 定 一 个 服务 ,但 是 只 有 所 有 这 些 
绑 定 被 解 绑 后 ,这 个 服务 才 被 销毁 。 

这 两 种 获得 服务 的 方法 并 不 是 完全 独立 的 ,在 某 些 情况 下 可 以 混合 使 用 。 例 如 在 
MP3 播放 器 中 ,可 以 通过 Context. startService() 方 法 启动 音乐 播放 的 后 台 服 务 ,但 在 播 
放 过 程 中 如 果 用 户 需 要 暂停 音乐 播放 , 则 需要 通过 Context. bindService ( ) 获取 
ServiceConnection 和 服务 对 象 ,进而 通过 调用 服务 对 象 中 的 方法 暂停 音乐 播放 ,并 保存 
相关 信息 。 在 这 种 情况 下 ,如 果 调 用 Context. stopService() 并 不 能 够 停止 Service, 需要 
在 所 有 的 ServiceConnection 关闭 后 ,Service 才能 够 真正 地 停止 。 

无 论 使 用 上 述 两 种 方式 的 一 种 ,还 是 同时 使 用 这 两 种 方式 获得 服务 ,都 需要 使 用 到 
Intent, 这 与 获得 Activity 组 件 的 方式 相同 。 


6.3.1 服务 的 生命 周期 


虽然 服务 的 生命 周期 比 Activity 的 生命 周期 简单 ,但 服务 的 生命 周期 非常 重要 。 
为 服务 在 后 台 运 行 ,有 时 用 户 甚至 意识 不 到 它 的 存在 ,所 以 我 们 更 多 关注 于 服务 如 何 创 建 
和 和 销毁。 服务 的 生命 周期 根据 创建 一 个 服务 的 方式 不 同 而 有 所 不 同 , 见 图 6. 3, 分 别 是 启 
动 方式 和 绑 定 方式 。 
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图 6.3 Service 的 生命 周期 


使 用 启动 方式 (startService) 创建 服务 时 ,一 个 组 件 调用 startService() 方 法 创建 服 
务 , 然 后 服务 无 限期 地 运行 ,并 且 必 须 通 过 调用 stopSelf() 方 法 来 终止 自己 。 其 他 组 件 也 
能 够 通过 调用 stopService() 方 法 来 终止 这 个 服务 。 当 服务 被 终止 ,系统 就 会 把 它 销 毁 。 

使 用 绑 定 方式 (bindService) 创 建 服务 时 , 当 有 一 个 组 件 调用 bindService() 方 法 时 , 服 
务 就 会 被 绑 定 ,客户 端 通过 IBinder 接口 与 服务 通信 。 客 户 端 能 够 调用 unbindService O 
方法 来 解除 与 服务 的 绑 定 。 可 以 有 多 个 客户 端 绑 定 到 一 个 服务 上 ,但 是 当 所 有 的 绑 定 都 
被 解除 以 后 ,系统 才 会 销毁 这 个 服务 ,而 服务 不 需要 终止 自己 。 

但 是 ,这 两 种 方式 是 完全 独立 的 ,我 们 能 够 绑 定 一 个 已 经 用 startService( ) 方 法 启动 
的 服务 。 例 如 ,我 们 可 以 通过 调用 startService() 方 法 启动 后 台 的 音乐 服务 ,这 个 方法 使 
用 Intent 标识 了 要 播放 的 音乐 ;之 后 如 果 用 户 想 要 进行 一 些 播放 器 的 控制 时 ,或 想 要 获 
取 有 关 当 前 歌曲 信息 时 ,我 们 可 以 在 一 个 Activity 中 通过 调用 bindService() 方 法 来 绑 定 
这 个 服务 。 直 到 所 有 的 客户 端 解 绑 后 ,stopService() 或 stopSelfO 〇 方法 才能 实际 终止 这 个 
服务 。 

要 创建 一 个 服务 ,必须 创建 一 个 Service 类 的 子 类 。Service 实现 中 ,需要 重 写 一 些 处 
理 服务 生命 周期 关键 特征 的 回调 方法 ,并且 给 组 件 提供 一 种 合适 的 绑 定 服务 的 机 制 。 

需要 重 写 的 回调 方法 包括 : 

e onStartCommand() 。 当 一 个 组 件 通过 调用 startService() 方 法 请 求 启动 一 个 服务 

时 ,系统 会 调用 这 个 服务 的 onStartCommand() 方 法 。 一 旦 这 个 方法 执行 了 ,那么 
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这 个 服务 就 被 启动 ,并 且 在 后 台 无 限期 地 运行 。 实 现 了 这 个 方法 , 当 服 务 的 工作 
结束 时 ,必须 调用 stopSelf() 方 法 或 stopService() 方 法 来 终止 服务 。 如 果 只 让 服 
务 提供 绑 定 的 能 力 ,不 需要 实现 这 个 方法 。 

onBind() 。 当 一 个 组 件 想 通过 调用 bindService() 方 法 跟 这 个 服务 (如 执行 RPC) 
绑 定时 ,系统 会 调用 这 个 方法 。 在 这 个 方法 的 实现 中 ,必须 通过 返回 一 个 IBinder 
对 象 给 客户 提供 一 个 用 户 跟 服务 进行 交互 的 接口 。 这 个 方法 必须 实现 ,但 是 如 果 
你 不 允许 绑 定 ,那么 这 个 方法 应 该 返回 null, 

onCreate()。 当 服务 被 第 一 次 创建 时 ,系统 会 调用 这 个 方法 来 执行 一 次 安装 过 
程 。 这 个 方法 在 onStartCommand() 或 onBind() 方 法 之 前 调用 。 如 果 服 务 正在 
运行 ,这 个 方法 就 不 会 被 调用 。 

onDestroy() 。 当 服务 不 再 使 用 或 正在 销毁 时 ,系统 会 调用 这 个 方法 。 服 务 需 要 
使 用 这 个 方法 来 实现 一 些 清理 资源 的 工作 ,如 清理 线程 .被 注册 的 监听 器 .接受 器 
等 。 这 是 服务 能 够 接受 的 最 后 的 调用 。 

如 果 组 件 通过 调用 startService( ) 方 法 启动 服务 ,这 样 会 调用 服务 onStartCommand() 
方法 ,那么 这 个 服务 就 会 一 直 运 行 ,一 直到 它 自 己 用 stopSelf() 方 法 终止 服务 ;或 男 一 个 
组 件 ,通过 调用 stopService() 方 法 来 终止 它 。 如 果 一 个 组 件 调 用 bindService( ) 方 法 来 创 
建 这 个 服务 ,并 且 没 有 调用 onStartCommand() 方 法 ,那么 这 个 服务 的 运行 时 间 与 绑 定 它 
的 组 件 运行 时 间 一 样 长 ,一 旦 这 个 服务 从 所 有 的 客户 端 解 绑 , 系 统 就 会 销毁 它 , 而 不 需 服 
务 自 己 或 其 他 组 件 停止 。 

Android 系统 只 有 在 内 存 不 足 ,并 且 为 用 户 提供 界面 响应 而 必须 释放 系统 资源 时 , 才 
会 强制 终止 一 个 服务 。 如 果 服 务 是 被 一 个 正在 与 用 户 进行 交互 的 Activity 绑 定 ,那么 它 
被 杀 死 的 可 能 性 很 小 ;如 果 这 个 服务 被 声明 运行 在 前 台 , 那 么 它 也 几乎 不 能 被 杀 死 。 但 
是 ,如 果 这 个 服务 被 启动 并 且 长 时 间 和 运行 ,那么 随 着 时 间 的 推移 系统 会 降低 它 在 后 台 任 务 
列表 中 位 置 , 并 且 这 个 服务 将 很 容易 被 杀 死 ;如 果 服 务 是 组 件 ,通过 startService( ) 方 法 启 
动 了 ,那么 必须 把 它 设计 成 能 够 通过 系统 妥善 地 处 理 重启 。 如 果 系 统 为 了 释放 资源 杀 死 
了 服务 ,就 需要 设计 当 资 源 可 用 时 怎样 有 效 重启 服务 ,当然 这 依赖 于 onStartCommand() 
方法 的 返回 值 。 

像 Activity 一 样 ,服务 也 有 生命 周期 回调 方法 ,可 以 通过 实现 这 些 回 调 方法 来 监测 服 
务 内 状态 的 改变 ,在 合适 的 时 机 执行 工作 。 代 码 6.5 示例 了 每 个 生命 周期 的 回调 方法 。 

代码 6.5 ExampleService. java 


public class ExampleService extends Service { 

int mStartMode; //indicates how to behave if the service is killed 
IBinder mBinder; //interface for clients that bind 

boolean mAllowRebind; //indicates whether onRebind should be used 


@override 
public void onCreate() { 


`> 
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像 Activity 一 样 ,所 有 的 服务 都 必须 在 应 用 程序 的 清单 文件 中 声明 。 要 声明 服务 就 
要 给 一 application 过 元 素 添 加 一 个 一 service 二 子 元 素 。 例 如 : 





在 一 service 之 元 素 中 还 包括 一 些 其 他 的 属性 定义 ,如 启动 服务 所 需 的 许可 和 服务 应 
该 运行 在 哪个 进程 中 。Android:name 属性 是 唯一 必需 的 属性 , 它 指定 了 这 个 服务 的 类 
名 。 一旦 应 用 发 布 了 ,就 不 应 该 改变 这 个 名 字 , 因 为 如 果 修 改 了 ,就 会 中 断 那些 使 用 
Intent 引用 这 个 服务 的 功能 。 关 于 在 清单 文件 中 声明 服务 的 更 多 信息 ,请 参考 <<service> 
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元 素 的 说 明 。 

就 像 Activity 一 样 ,一 个 服务 也 能 够 定义 Intent 过 滤器 ,允许 其 他 组 件 使 用 隐 含 的 
Intent 来 调用 这 个 服务 。 通 过 声明 Intent 过 滤器 ,安装 在 用 户 设备 上 的 任何 应 用 程序 组 
件 都 能 在 符合 条 件 的 情况 下 启动 该 服务 。 


632 创建 启动 类 型 服务 


Android 的 一 个 组 件 可 以 通过 调用 startService() 方 法 创建 一 个 启动 类 型 的 Service, 
并 调用 服务 的 onStartCommand() 方 法 来 启动 服务 。 一 个 服务 一 旦 被 启动 , 它 就 具有 了 
一 个 独立 于 启动 它 的 组 件 的 生命 周期 ,并 且 这 个 服务 能 够 无 限期 地 在 后 台 运行 ,即使 启动 
它 的 组 件 被 销毁 。 
Activity 之 类 的 应 用 程序 组 件 在 通过 调用 startService() 方 法 来 启动 Service 时 ,需要 
给 指定 的 Service 传递 一 个 Intent 对 象 , 携带 一 些 服务 所 使 用 的 数据 。Service 在 
onStartCommand() 方 法 中 接受 这 个 Intent 对 象 。 例 如 ,假设 一 个 Activity 需要 把 一 些 数 
据 保存 到 在 线 数据 库 中 。 这 个 Activity 就 能 启动 一 个 服务 ,并 且 把 要 保存 的 数据 通过 一 
个 Intent 对 象 传递 给 startService() 方 法 。 这 个 服务 在 onStartCommand() 方 法 中 接受 这 
个 Intent 对 象 ,连接 到 互联 网 ,并 且 执 行 数据 库 事 务 。 当 事务 结束 ,这 个 服务 就 自己 终止 
并 销毁 。 
但 是 ,服务 运行 的 进程 与 声明 它 的 应 用 程序 的 进程 是 同一 个 进程 ,并 且 是 在 应 用 程序 
的 主线 程 中 。 默 认 情 况 下 ,如果 服 务 要 执行 密集 或 阻塞 操作 ,而 用 户 又 要 跟 同一 个 应 用 程 
序 的 一 个 Activity 进行 交互 ,那么 这 个 服务 就 会 降低 Activity 的 性 能 。 要 避免 影响 应 用 
程序 的 性 能 ,需要 在 服务 的 内 部 启动 一 个 新 的 线程 。 
创建 启动 类 型 的 服务 ,通常 可 以 通过 两 种 方式 来 实现 : 
。 继承 Service。Service 是 所 有 服务 的 基 类 。 当 通过 继承 这 个 类 创建 启动 类 型 服务 
时 ,重要 的 是 要 给 这 个 服务 创建 一 个 新 的 线程 ,避免 其 占用 应 用 程序 的 主线 程 , 影 
响 正 在 运行 的 Activity 的 性 能 。 
。 继承 IntentService, IntentService 是 Service 类 的 子 类 , 它 可 以 使 用 工作 线程 来 依 
次 处 理 所 有 的 启动 请 求 ,如 果 所 需 创 建 的 服务 不 用 同时 处 理 多 个 请 求 ,那么 这 是 
最 好 的 选择 。 当 通过 继承 这 个 类 创建 启动 类 型 服务 时 ,需要 做 的 所 有 工作 就 是 实 
现 onHandlelIntent() 方 法 , 它 接受 每 个 启动 请 求 的 Intent 对 象 ,以 便 完成 后 台 
正 作 。 
1. IntentService 
IntentService 是 Service 类 的 子 类 ,用 于 处 理 异 步 请 求 。 因 为 大 多 被 启动 类 型 的 服务 
不 需要 同时 处 理 多 个 请 求 , 所 以 使 用 IntentService 类 来 实现 自己 的 服务 可 能 是 最 好 的 选 
择 。 客 户 端 可 以 通过 startService(Intent) 方 法 传递 请 求 给 IntentService。 
首先 分 析 IntentService 源 代码 , 见 代 码 6. 8, 它 是 IntentService 抽象 类 的 具体 定义 代 
码 。 从 IntentService 的 定义 中 可 以 看 出 , IntentService 实际 上 是 Looper、 Handler、 
Service 的 集合 体 , 它 不 仅 有 服务 的 功能 ,还 有 消息 处 理 和 消息 循环 的 功能 。 
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代码 6.6 IntentService. java 
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Message msg=mServiceHandler.obtainMessage () ; 
msg.argl=startId; 

msg .obj=intent; 

mServiceHandler .sendMessage (msg); 


@override 

public int onStartCommand(Intent intent, int flags, int startId) { 
onStart(intent, startId); 
return mRedelivery ? START_REDELIVER_INTENT : START_NOT_STICKY; 


@override 
public void onDestroy() { 
mServiceLooper.quit(); 


) 


@override 
public IBinder onBind(Intent intent) ( 


return null; 


protected abstract void onHandleIntent(Intent intent); 


) 


IntentService 在 处 理事 务 时 ,还 采用 Handler 方式 ,创建 一 个 名 叫 Service Handler 的 
内 部 Handler, 并 把 它 直 接 绑 定 到 HandlerThread 所 对 应 的 子 线程 。 

ServiceHandler 把 处 理 Intent 所 对 应 的 事务 的 代码 都 封装 到 onHandleIntent() 回 调 
方法 中 ,因此 直接 实现 onHandleIntent() 方 法 ,再 在 里 面 根据 Intent 的 不 同 进行 不 同 的 事 
务 处 理 就 可 以 了 。 另 外 ,IntentService 默认 实现 了 onBind() 方 法 ,返回 值 为 Null。 

继承 IntentService 的 好 处 是 处 理 异步 请 求 的 时 候 可 以 减少 写 代码 的 工作 量 , 能 比较 
轻松 地 实现 项 目的 需求 。IntentService 的 构造 方法 一 定 是 参数 为 空 的 构造 方法 ,然后 再 
在 其 中 调用 父 类 的 构造 方法 super("name")。 因 为 Service 的 实例 化 是 系统 来 完成 的 ,而 
且 系 统 是 用 参数 为 空 的 构造 方法 来 实例 化 Service 的 ,所 以 我 们 只 需要 实现 
onHandleIntent() 方 法 ,来 完成 由 客户 提供 的 工作 。 

下 面 是 一 个 使 用 IntentService 创建 启动 服务 的 简单 例子 ,在 onHandleIntent() 方 法 
中 实现 了 模拟 下 载 文件 时 耗 时 的 状况 ,具体 实现 代码 见 代 码 6.7。 

代码 6.7 HelloIntentService. java 

















public class HelloIntentService extends IntentService { 


/x* 


* A constructor is required, and must call the super IntentService (String) 
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代码 6.7 中 只 是 定义 了 一 个 构造 方法 和 onHandleIntent() 方 法 ,如 果 还 要 重 写 
onCreate() .onStartCommand() 或 onDestroy() 等 其 他 回调 方法 时 ,必须 要 调用 父 类 相同 
的 回调 方法 ,以 便 IntentService 对 象 能 够 适当 地 处 理工 作 线 程 的 活动 。 例 如 ,要 在 代码 
6.7 中 添加 onStartCommand() 方 法 的 实现 代码 , 则 在 这 个 方法 的 实现 代码 中 , 必须 执行 
语句 super. onStartCommand ( ) 来 调用 父 类 的 同一 回调 方法 ,使 得 本 类 的 
onStartCommand() 方 法 获取 Intent 并 将 其 交付 给 onHandleIntent() 方 法 。 


除了 onHandleIntent() 方 法 以 外 ,唯一 不 需要 调用 实现 的 方法 是 onBind() 方 法 ,但 
是 如 果 服 务 允 许 绑 定 , 就 要 实现 这 个 方法 。 
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2. Service 


继承 IntentService 类 来 实现 一 个 被 启动 类 型 的 服务 很 简单 ,但 是 如 果 服 务 要 执行 多 
线程 ,而 不 是 通过 工作 队列 来 处 理 启动 请 求 ,那么 就 需要 定义 Service 类 的 子 类 来 处 理 每 
个 Intent, 

为 便于 比较 ,在 代码 6. 8 所 示 的 例子 中 ,使 用 继承 Service 类 的 方式 创建 了 一 个 服务 ， 
执行 了 与 上 节 继 承 IntentService 类 的 代码 6. 7 相同 的 工作 。 但 与 代码 6.7 的 处 理 方式 不 
同 ,其 对 于 每 个 启动 请 求 , 它 都 会 使 用 一 个 工作 线程 来 执行 工作 ,并 且 每 次 只 处 理 一 个 
请 求 。 

代码 6.8 HelloService. java 
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在 代码 6. 8 中 ,Service 创建 时 会 调用 onCreate() 方 法 。 在 onCreate() 方 法 中 创建 
Handler 线程 (HandlerThread) 后 启动 此 线程 ,然后 获取 当前 线程 的 Looper 对 象 来 初始 
化 Service 的 mServiceLooper, 并 创建 mServicehandler 对 象 。 

当 一 个 组 件 通 过 调用 startService() 方 法 请 求 启动 一 个 服务 时 ,系统 会 调用 这 个 服务 
的 onStartCommand() 方 法 。 对 于 每 一 个 启动 Service 的 请 求 ,都 会 产生 一 条 带 有 startId 
和 Intent 的 消息 ,并 发 送 到 消息 队列 中 。ServiceHandler 通过 继承 Handle 来 实现 服务 请 
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求 的 多 任务 处 理 ,具体 的 原理 和 细节 可 以 参考 6. 2 节 的 内 容 。 

继承 Service 实现 服务 比 继承 IntentService 类 多 做 很 多 工作 。 但 是 ,因为 我 们 自己 
处 理 每 个 onStartCommand() 方 法 的 调用 ,所 以 就 能 够 同时 执行 多 个 请 求 。 在 代码 6.8 
所 示 的 例子 中 没有 这 么 做 ,但 是 如 果 想 要 这 么 做 的 话 , 那 么 可 以 给 每 个 请 求 创建 一 个 新 的 
线程 ,并 且 立 即 运行 它们 ,而 不 需要 等 待 前 一 个 请 求 完 成 。 

3. 启动 和 终止 服务 

Android 的 一 个 组 件 可 以 通过 调用 startService() 方 法 创建 一 个 启动 类 型 的 Service, 
并 调用 服务 的 onStartCommand() 方 法 来 启动 的 服务 。 

当 一 个 服务 定义 完成 后 ,可 以 在 其 他 组 件 中 通过 创建 符合 条 件 的 Intent 对 象 或 显示 
指定 要 启动 的 服务 ,并 且 将 其 传递 给 StartService() 方 法 ,这 样 就 可 以 实现 从 一 个 
Activity 或 其 他 的 应 用 程序 组 件 启动 服务 。 例 如 ,在 Activity 的 onCreate() 代 码 中 添加 
如 下 代码 ,能 够 创建 显示 指定 的 Intent 对 象 ,并 把 其 作为 startService() 方 法 的 参数 来 启 
动 指定 的 HelloService 服务 。 代 码 如 下 : 


Intent intent=new Intent (this, HelloService.class); 
startService (intent); 


服务 一 旦 运行 ,就 能 够 使 用 广播 通知 (Toast Notification) 或 状态 栏 通知 (Status Bar 
Notification) 来 通知 用 户 。 通 常 ,状态 栏 通知 是 用 来 告知 后 台 任 务 完成 得 最 好 的 技术 (如 
文件 下 载 完成 ) ,并 且 用 户 能 够 采取 相应 的 动作 。 

启动 类 型 的 服务 必须 管理 它 自己 的 生命 周期 ,除非 系统 要 回收 系统 内 存 , 和 否则 系统 不 
会 终止 或 销毁 这 个 服务 。 因 此 而 这 种 类 型 的 服务 必须 通过 调用 stopSelf() 方 法 或 另 一 个 
组 件 通过 调用 stopService() 方 法 才能 终止 。 一 旦 用 stopSelf() 方 法 或 stopService() 方 法 
请 求 终止 服务 ,那么 系统 一 有 可 能 就 会 销毁 这 个 服务 。 


633 创建 绑 定 类 型 服务 


绑 定 类 型 服务 允许 组 件 ( 如 Activity) 绑 定 服务 ,实现 发 送 请 求 、 接 收 响应 以 及 执行 进 
程 间 通 信 。 一 个 典型 的 绑 定 类 型 的 服务 只 跟 它 所 绑 定 的 应 用 程序 组 件 同时 存在 ,并 且 不 
在 后 台 无 限期 地 运行 。 绑 定 类 型 的 服务 是 客户 端 和 服务 端 之 间 交 互 的 服务 端 。 

要 创建 绑 定 类 型 的 服务 ,首先 要 定义 接口 ,用 于 指定 客户 端 怎样 跟 服务 进行 通信 。 服 
务 和 客户 端 之 间 的 接口 必须 是 一 个 IBinder 接口 的 实现 ,并 且 要 求 必须 从 onBind() 回 调 
方法 返回 这 个 IBinder 接 口 对 象 。 一 旦 客户 端 收 到 了 IBinder 对 象 , 就 能 通过 这 个 接口 开 
始 与 服务 进行 交互 。 多 个 客户 端 能 够 同时 绑 定 这 个 服务 。 当 客户 端 完 成 与 服务 的 交互 
时 , 它 调 用 unbindService() 方 法 来 解 贿 。 一 旦 没有 客户 端 绑 定 这 个 服务 ,系统 就 会 销 
RE. 

客户 端 通过 调用 bindService () 方 法 绑 定 服务 。 客 户 端 绑 定 服务 时 ,必须 提供 
ServiceConnection 类 的 对 象 ,并 且 实 现 其 方法 ,用 来 监视 服务 端的 连接 。bindService() 方 
法 不 带 有 返回 值 , 并 立即 返回 ,但 是 当 Android 系统 在 客户 端 和 服务 端 创建 连接 时 , 它 会 
在 ServiceConnection 上 调用 onServiceConnected() 方 法 来 发 送 客 户 端 跟 服务 端 进行 交互 


so 
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用 的 IBinder 对 象 。 

多 个 客户 端 能 够 连接 到 同一 个 服务 上 ,但 是 只 在 第 一 个 客户 端 绑 定 时 ,系统 调用 服务 
的 onBind() 方 法 来 发 送 获 取 对 象 。 然 后 系统 会 给 其 他 任何 绑 定 的 客户 端 发 送 相同 的 
IBinder 对 象 ,而 不 会 再 次 调用 onBind() 方 法 。 当 最 后 的 客户 端 从 服务 上 解 绑 , 系 统 就 会 
销毁 这 个 服务 但 这 个 服务 也 通过 startService() 方 法 启动 了 的 情况 除外 。 

在 实现 绑 定 类 型 的 服务 时 ,最 重要 的 部 分 是 定义 onBind() 回 调 方法 返回 的 接口 。 有 
很 多 不 同 的 方法 能 够 定义 服务 的 IBinder 接口 ,在 这 一 节 下 面 的 内 容 中 会 分 别 讨论 这 些 
技术 。 有 三 种 方法 能 够 定义 这 个 接口 。 

。 继承 Binder 类 。 如 果 我 们 的 服务 对 应 用 程序 来 说 是 私有 服务 ,并 且 跟 客户 端 运 

行 在 同一 个 进程 中 ,也 就 是 为 本 地 服务 ,那么 就 应 该 通过 继承 Binder 类 来 创建 接 
口 ,并 且 通 过 onBind() 方 法 返回 这 个 接口 的 一 个 实例 。 客 户 端 接 收 这 个 Binder 
对 象 ,并 且 能 够 直接 访问 其 实现 的 或 Service 中 的 公共 方法 。 如 果 只 是 在 后 台 自 
己 的 应 用 程序 提供 服务 ,这 是 首选 方法 。 只 有 被 其 他 应 用 程序 或 者 跨 进程 使 用 
时 ,我 们 才 考 虑 使 用 其 他 方法 。 

。 使 用 Messager。 如 果 你 的 接口 要 跨越 不 同 进 程 来 进行 工作 ,那么 你 能 用 

Messager 给 服务 创建 接口 。 在 这 种 方式 中 ,服务 定义 了 响应 不 同 消息 对 象 类 型 
的 处 理 器 。 这 个 处 理 器 是 一 个 Messager 的 基础 , 它 能 够 跟 客户 端 共享 一 个 
IBinder 对 象 , 允 许 客户 端 使 用 Message 对 象 给 服务 端 发 送 命令 。 另 外 ,客户 端 能 
够 定义 一 个 自己 的 Messager, 以 便服 务 端 能 够 给 客户 端 发 送 消息 。 这 是 执行 进 
程 间 通信 (IPC) 最 简单 的 方法 ,因为 Messager 队列 的 所 有 请 求 都 在 一 个 单线 程 
中 ,因此 不 需要 针对 线程 安全 来 设计 你 的 服务 。 
使 用 AIDL。AIDL 为 接口 定义 语言 (Android Interface Definition Language) ,用 
来 将 对 象 分 解 成 操作 系统 能 够 理解 的 原 语 ,并 且 将 它们 在 进程 之 间 编 组 ,完成 进 
程 间 通信 。Message 技术 实际 上 是 基于 AIDL 架构 。 就 像 前 面 提 到 的 , Message 
在 一 个 单线 程 中 创建 了 一 个 所 有 客户 端 请 求 的 队列 ,因此 服务 每 次 只 能 接收 一 个 
请 求 。 但 是 ,如 果 想 要 同时 处 理 多 个 请 求 ,那么 可 以 直接 使 用 AIDL。 这 种 情况 
下 ,我们 的 服务 必须 是 多 线程 的 并 且 要 线程 安全 。 要 使 用 直接 AIDL ,就 必须 创建 
一 个 定义 编程 接口 的 .aidl 文件 。Android SDK 使 用 这 个 文件 生成 一 个 实现 文件 
中 定义 的 接口 和 处 理 IPC 的 抽象 类 ,然后 能 够 在 服务 中 进行 扩展 。 大 多 数 应 用 程 
序 不 应 该 使 用 AIDL 方法 来 创建 绑 定 类 型 的 服务 ,因为 它 可 能 需要 多 线程 的 能 
力 , 并 可 能 导致 更 复杂 的 实现 ,因此 AIDL 不 适用 于 大 多 数 应 用 程序 。 

1. 继承 Binder 类 

如 果 只 在 应 用 程序 的 局 部 使 用 服务 ,并 且 不 需要 跨 进 程 工作 ,程序 员 可 以 实现 自己 的 
Binder 类 ,用 它 直 接 为 客户 端 提 供 访问 服务 。 通 常 , 客 户 端 和 服务 端 只 是 在 同一 个 应 用 
和 进程 中 工作 ,不 为 第 三 方 应 用 程序 提供 服务 。 例 如 ,对 于 一 个 需要 良好 工作 的 播放 音乐 
的 应 用 程序 ,就 需要 把 在 后 台 工 作 的 播放 音乐 的 服务 与 应 用 的 一 个 Activity 绑 定 。 使 用 
继承 Binder 类 来 定义 服务 的 IBinder 接口 的 步骤 如 下 : 
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(1) 在 Service 中 创建 一 个 Binder 的 实例 。 

。 这 个 实例 包含 Client 可 以 调用 的 public() 方 法 ; 

。 这 个 实例 返回 当前 Service 对 象 ,其 包含 Client 可 以 调用 的 public() 方 法 ; 

。 这 个 实例 返回 Service 类 中 的 一 个 类 对 象 ,而 这 个 类 对 象 包含 Client 可 以 调用 的 

public() 方 法 。 

(2) 在 Service 的 onBind() 方 法 中 返回 这 个 Binder 实例 。 

(3) 在 Client 端的 onServiceConnected() 方 法 中 获得 这 个 Binder 实例 ,并 通过 这 个 
Binder 实例 调用 Service 端的 public() 方 法 。 

服务 端 和 客户 端 必须 在 同一 个 应 用 ,原因 是 客户 端 能 够 转换 返回 的 对 象 ,并 正确 地 调 
用 自己 的 API。 服 务 端 和 客户 端 也 必须 是 在 同一 个 进程 中 ,因为 这 种 技术 不 执行 任何 跨 
进程 处 理 。 代 码 6.9 是 通过 继承 Binder 绑 定 服务 的 一 个 简单 例子 。 

代码 6.9 LocalService. java 









































public class LocalService extends Service { 
//Binder given to clients 

private final IBinder mBinder=new LocalBinder(); 
//Random number generator 


private final Random mGenerator=new Random(); 


/x¥ 

* Class used for the client Binder. Because we know this service always 

* runs in the same process as its clients, we don't need to deal with IPC. 
*/ 

public class LocalBinder extends Binder { 

LocalService getService() { 

//Return this instance of LocalService so clients can call public methods 
return LocalService.this; 

} 

} 


@override 
public IBinder onBind(Intent intent) { 
return mBinder; 


) 


/xx method for clients * / 
public int getRandomNumber () ( 
return mGenerator.nextInt(100); 
j: 

i 


在 代码 6. 9 中 , LocalBinder 对 象 给 客户 端 提 供 了 getService ( ) 方法 ,并 在 
LocalService 的 成 员 变量 定义 时 ,通过 实例 化 IBinder 变量 返回 当前 服务 的 实例 ,使 得 客 
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户 端 用 这 个 方法 能 够 获取 LocalService 服务 的 当前 实例 。 这 样 就 允许 客户 端 调用 服务 中 
的 public() 方 法 。 
完成 服务 本 身 的 定义 后 ,第 三 步 就 是 从 客户 端 绑 定 定义 完成 的 服务 。 所 谓 客户 端 ,就 
是 需要 与 服务 绑 定 的 Activity 之 类 的 组 件 。 这 需要 在 组 件 中 做 几 个 工作 : 
。 重 写 两 个 回调 方法 onServiceConnected () 和 OnServiceDisconnected ( ) , 实现 
ServiceConnection O 。 
。 调用 bindService() , 传 给 它 ServiceConnection 的 实现 。 
。 使 用 接口 定义 的 方法 们 调用 Service。 
。 在 需要 与 Service 断 开 绑 定 连接 时 ,调用 unbindService() 。 
代码 6. 10 是 一 个 例子 ,Activity 代码 绑 定 了 LocalService 服务 ,并 且 在 单 击 一 个 按钮 
时 调用 了 服务 public() 方 法 : getRandomNumber() 方 法 。 
代码 6. 10 BindingActivity. java 
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代码 6. 10 显示 了 客户 端 怎样 使 用 ServiceConnection 接口 和 onServiceConnected 回 
调 方法 来 绑 定 服务 的 。 

2. 使 用 Messenger 

如 果 服 务 需 要 与 远程 进程 通信 ,就 可 以 使 用 Messenger 对 象 来 给 服务 提供 接口 。 使 
用 这 种 方式 定义 服务 与 客户 端的 接口 需要 的 步 又 如 下 : 

(1) 在 Service 内 部 实现 Handler 接口 ,用 于 处 理 从 每 一 个 Client 发 送 过 来 的 请 求 。 

(2) 使 用 该 Handler 创建 一 个 Messenger 对 象 。 

(3) 该 Messenger 在 Service 的 onBind() 方 法 中 创建 一 个 IBinder 实例 ,返回 给 
Client。 

(4) Client 使 用 从 Service 返回 的 IBinder 实例 来 初始 化 一 个 Messenger, 然 后 用 其 给 
Service 发 送 Message 对 象 。 
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(5) Service 在 它 的 处 理 器 (Handler) 的 handleMessage() 方 法 中 依次 接收 每 个 
Message 对 象 ,进行 处 理 。 

使 用 这 种 方法 ,客户 端 没有 调用 服务 端的 任何 方法 ,相反 客户 端 会 给 发 送 服务 端 
Message 对 象 ,服务 端 会 在 它 的 处 理 器 中 接收 这 些 消 息 对 象 。 

下 面 是 一 个 例子 ,说 明了 如 何 使 用 Messenger 接口 定义 绑 定 的 服务 , 见 代码 6. 11。 

代码 6.11 MessengerService. java 
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代码 6.11 中 IncomingHandler 类 中 定义 的 handleMessage() 方 法 ,能 够 接受 客户 端 
输入 Message 对 象 ,并 根据 Message 的 what 成 员 属 性 做 出 判断 。 客 户 端 需要 做 的 所 有 
工作 就 是 基于 服务 端 返 回 的 IBinder 对 象 创建 一 个 Messenger 对 象 ,并 且 使 用 该 
Messenger 对 象 的 send() 方 法 发 送 消息 。 

代码 6. 12 是 一 个 简单 的 Activity 代码 , 它 作 为 客户 端 绑 定 服务 ,并 且 给 服务 发 送 
MSG_SAY_HELLO 消息 。 

代码 6. 12 ActivityMessenger. java 
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在 前 面 的 例子 中 ,通过 Messager 定义 接口 ,实现 了 Client 向 Service 发 送 消息 ， 
Service 中 的 Handler 对 消息 做 出 响应 和 处 理 。 但 这 个 例子 实现 的 仅 是 单 向 通信 , 即 
Client 给 Service 发 送 消息 ,并 没有 实现 Service 处 理 完 成 后 向 Client 发 送 消息 。 如 果 需 
要 Service 给 Client 发 送 消息 又 该 如 何 实 现 呢 ? 

这 个 实现 的 过 程 与 前 面 五 步 类 似 ,只 是 Client 和 Service 在 实现 过 程 中 角色 有 所 变 
化 。 可 以 接着 上 面 的 步 又 继续 来 实现 双向 通信 。 

(6) 在 Client 中 创建 一 个 Handler 对 象 ,用 于 处 理 Service 发 过 来 的 消息 。 

(7) 使 用 Client 中 的 该 Handler 对 象 创建 一 个 Client 自己 的 Messenger 对 象 。 

(8) 在 前 面 第 (4) 步 ,客户 端 获取 了 Service 的 Messenger 对 象 ,并 通过 它 来 给 Service 
发 送 消 息 。 在 向 Service 发 送 消息 之 前 ,将 Message 对 象 的 replyTo 字段 设置 成 第 (7) 步 
创建 的 Messenger 对 象 。 

(9) Service 的 Handler 处 理 Message 时 ,将 Message 对 象 的 replyTo 字段 提取 出 
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来 ,并 使 用 其 给 Client 发 送 消息 。 

这 样 就 实现 了 Client 和 Service 的 双向 通信 。Client 和 Service 都 有 自己 的 Handler 
和 Messenger 对 象 , 使 得 对 方 可 以 给 自己 发 送 消 息 。Client 的 Messenger 是 通过 
Message 的 replyTo 传递 给 Service 的 。 


6.4 本 章 小 结 


本 章 主要 介绍 了 Android 系统 多 任务 的 机 制 和 Service 这 个 基本 的 组 件 。 

Android 多 任务 的 调度 和 实现 采用 消息 驱动 机 制 。 应 用 程序 启动 时 ,系统 会 为 它 创 
建 一 个 名 为 main 的 主线 程 。 默 认 情况 下 ,同一 个 应 用 程序 的 所 有 组 件 都 运行 在 同一 个 进 
程 的 这 个 “主线 程 ? 里 。 如 果 和 希望 Android 应 用 程序 实现 多 任务 ,可 以 通过 代码 指定 组 件 
运行 在 其 他 进程 里 ,或 为 进程 创建 额外 的 线程 。 

Android 线程 之 间 和 进程 之 间 是 不 能 直接 传递 消息 的 ,必须 通过 对 消息 队列 和 消息 
循环 的 操作 来 完成 。Android 消息 循环 是 针对 线程 的 ,每 个 线程 都 可 以 有 自己 的 消息 队 
列 和 消息 循环 。Andriod 提供 了 Handler 类 和 Looper 类 来 访问 消息 队列 (Message 
Queue), Android 有 两 种 方式 实现 多 线程 操作 UI: 第 一 种 是 创建 新 线程 Thread, 用 
Handler 负责 线程 间 的 通信 和 消息 ;第 二 种 方式 是 AsyncTask 异步 执行 任务 。 

Service 是 Android 的 四 大 组 件 之 一 ,用 于 支持 Android 系统 的 服务 。Service 不 能 与 
用 户 交互 ,也 不 能 自己 启动 ,需要 调用 Context. startService() 或 Context. bindService() 
来 启动 ,在 后 台 运 行 。Android 的 其 他 应 用 组 件 可 以 在 后 台 启 动 一 个 Service 运行 ,即使 
用 户 切 换 到 另 一 个 应 用 ,此 Service 也 会 继续 运行 。 无 论 使 用 哪 一 种 方式 启动 ,还 是 同时 
使 用 这 两 种 方式 获得 服务 ,都 需要 使 用 Intent, 
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任何 应 用 程序 都 可 以 通过 文件 系统 存储 文件 ,其 他 应 用 程序 可 以 来 读 取 这 些 文件 , 当 
然 这 可 能 需要 访问 权限 的 设置 。Android 提供 几 种 持久 化 应 用 程序 数据 的 选择 ,具体 选 
择 哪 种 方式 依赖 于 具体 的 需求 ,例如 数据 应 该 是 应 用 程序 私有 的 还 是 共享 的 ,或 者 数据 所 
需要 的 存储 空间 等 。 

在 Android 中 ,应 用 程序 的 所 有 数据 对 其 他 应 用 程序 都 是 私有 的 ,其 他 应 用 只 有 通过 
设置 权限 才 可 以 获取 数据 。Android 系统 提供 了 几 种 本 地 数据 的 存储 方式 ,如 果 要 将 这 
些 数据 共享 ,Android 通过 定义 内 容 提供 器 (Content Provider) ,能 够 把 私有 数据 共享 给 
其 他 应 用 程序 。 内 容 提供 器 是 一 种 为 了 开放 应 用 程序 的 数据 读 写 `. 具 有 访问 权限 的 可 选 
组 件 , 可 以 通过 该 组 件 实现 私有 数据 的 读 写 访 问 。 内 容 提 供 器 提供 了 请 求 和 修改 数据 的 
标准 语法 和 读 取 返 回 数据 的 标准 机 制 。Android 为 标准 的 数据 类 型 提供 了 一 些 内 容 提供 
器 ,如 图 像 、 视 频 和 音频 文件 ,以 及 个 人 通讯 录 信息 。 


7.1 本 地 数据 存储 


Android 的 应 用 程序 可 以 选择 的 数据 存储 方式 包括 以 下 几 种 。 

。 Shared Preferences; 用 键 值 对 的 形式 保存 私有 的 原始 数据 。 

Internal Storage; 在 设备 的 内 部 存储 上 保存 私有 的 数据 ,这 是 内 置 在 设备 中 不 可 
以 任意 移 除 的 存储 。 

External Storage: 在 共享 的 外 部 存储 器 上 保存 公共 的 数据 ,这 是 扩充 的 存储 ,可 
以 任意 移 除 。 

SQLite 数据 库 : 在 私有 的 数据 库 中 保存 结构 化 的 数据 。 

Network Connection: 把 数据 保存 在 自己 的 互联 网 服务 器 上 ,例如 云 存 储 。 本 章 
主要 介绍 本 地 数据 的 存储 ,所 以 这 部 分 暂时 不 介绍 。 


7.2 Preference 的 存 取 与 设置 


当 应 用 程序 需要 保存 配置 偏好 时 ,不 同 软件 系统 都 有 对 应 的 解决 方法 。 例 如 
Microsoft Windows 系统 通常 采用 ini 文件 进行 保存 ;J2EE 应 用 采用 properties 属性 文件 
或 者 XML 文件 进行 保存 。Android 提供 了 一 种 Shared Preference 的 存储 方式 ,可 以 称 
其 为 共享 偏好 的 存储 方式 。Shared Preference 存储 方式 类 似 Windows 系统 上 的 ini 配置 
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文件 ,不 同 之 处 是 它 分 为 多 种 权限 ,可 以 全 局 共享 访问 。Shared Preference 方式 主要 用 于 
保存 一 些 常 用 的 配置 ,如 窗口 状态 。 例 如 ,可 以 通过 它 保存 上 一 次 用 户 所 做 的 修改 或 者 自 
定义 参数 设 定 , 当 再 次 启动 程序 后 依然 保持 原 有 设置 。 

应 用 程序 通常 包括 允许 用 户 修 改 应 用 程序 的 特性 和 行为 的 设置 功能 。 例 如 ,一 些 应 
用 程序 允许 用 户 指定 通知 是 否 启用 或 指定 多 久 使 用 云 同步 数据 。 如 果 要 为 应 用 程序 提供 
设置 Shared Preferences 的 功能 ( 见 图 7. 1) ,需要 使 用 Android 的 Preference APIs 来 构 
建 统一 的 接口 。 


STORAGE 
Delete old messages 


Delete old messages əs limits are 
reached 


Text message limit 
500 messages per conversation 


Multimedia message limit 
50 messages per conversation 
TEXT (SMS) MESSAGES 
Delivery reports 

Request a delivery report for each 
message you send 


Manage SIM card messages 
Manage messages stored on your SIM card 


MULTIMEDIA (MMS) MESSAGES 
Delivery reports 


Request a delivery report for each 
message you send 


图 7.1 特性 和 行为 的 设置 





7.2.1 存 取 Shared Preferences 


Shared Preferences 是 一 种 轻 量 级 机 制 ,其 使 用 键 值 对 能 够 保存 任意 类 型 的 原始 类 型 
数据 : 布尔 型 浮 点 型 整数 型 以 及 字符 串 。 存 储 的 时 候 类 似 于 Map 的 key-Value( 键 值 ) 对 。 
Shared Preferences 采用 XML 格式 将 数据 存储 到 设备 中 ,路 径 为 data/ data/ 包 名 / 
share_prefs/ 文 件 名 . xml。Shared Preference 处 理 数 据 有 三 种 模式 : 
。 MODE_PRIVATE: 表示 只 有 创建 这 个 Preferences 的 程序 才能 访问 这 个 
Preferences。 这 是 默认 的 模式 。 
MODE_WORLD_READABLE: 表示 其 他 程序 对 这 个 Shared Preferences 只 有 只 
读 权限 。 
。 MODE_WORLD_WRITEABLE: 表示 其 他 程序 同时 拥有 读 写 权 限 。 
如 果 在 应 用 程序 中 要 获取 一 个 Shared Preferences 对 象 , 有 两 种 方法 : 
。 Context. getSharedPreferences(String name,int mode) : name 为 本 组 件 的 配置 文 
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件 名 ,mode 为 操作 模式 ,默认 的 模式 为 0 或 MODE_PRIVATE。 
。 Activity. getPreferences(int mode); 这 个 方法 由 于 没有 配置 文件 名 ,配置 文件 仅 
可 以 被 调用 的 Activity 使 用 。 

获取 Shared Preferences 对 象 后 ,就 可 以 对 其 进行 读 写 。 

如 果 要 读 取 Shared Preferences 中 的 文件 信息 ,只 需要 针对 文件 中 所 存储 的 数据 类 
型 ,直接 使 用 Shared Preferences 对 象 的 getXXX() 方 法 ,例如 getString() 、getInt() 或 
getBoolean() 方 法 ,根据 键 值 对 读 出 数据 。 

如 果 要 向 Shared Preferences 文件 中 写 入 信息 , 则 必须 先 调用 Shared Preferences 对 
象 的 edit() 方 法 获取 一 个 SharedPreferences. Editor 对 象 ,使 其 处 于 可 编辑 状态 ,然后 再 
调用 Editor 对 象 的 putXXX() 方 法 向 文件 中 按键 值 对 的 方式 写 人 数据 ,最 后 调用 commit() 
方法 提交 更 改 后 的 配置 文件 。 

下 面 是 一 个 简单 的 例子 ,设置 当前 的 Activity 按键 静音 模式 。 其 采用 了 Map 数据 结 
构 来 存储 数据 ,以 键 值 的 方式 存储 ,可 以 简单 地 读 取 与 写 人 , 见 代码 7. 1。 

代码 7.1 Calc, java 


public class Calc extends Activity { 
public static final String PREFS NAME="MyPrefsFile"; 


@override 
protected void onCreate (Bundle state) ( 


super.onCreate (state); 


//Restore preferences 

SharedPreferences settings=getSharedPreferences (PREFS NAME, 0); 
boolean silent=settings.getBoolean("silentMode", false); 
setSilent (silent); 


@override 
protected void onstop(){ 
super.onStop(); 


//We need an Editor object to make preference changes. 

//A11 objects are from android.context.Context 

SharedPreferences settings=getSharedPreferences (PREFS NAME, 0); 
SharedPreferences.Editor editor=settings.edit(); 
editor.putBoolean ("silentMode", mSilentMode); 


//Commit the edits! 
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editor.commit (); 
) 
} 


数据 读 取 与 写 入 的 方法 都 非常 简单 ,只 是 在 写 入 的 时 候 需 要 先 调用 edit() 获取 
SharedPreferences. Editor 对 象 ,然后 使 用 这 个 对 象 写 人 数据 ,最 后 使 用 commit() 提 交 。 
Shared Preferences 是 采用 了 XML 格式 将 数据 存储 到 设备 中 , 放 在 DDMS 中 的 File 
Explorer 中 的 /data/data/ 一 package name> /shares_prefs F. 

使 用 Shared Preferences 是 有 些 限 制 的 : 只 能 在 同一 个 包 内 使 用 ,不 能 在 不 同 的 包 之 
间 使 用 。 


7.2.2 理解 Preference 框架 


当 开发 移动 应 用 时 ,通常 需要 存储 用 户 的 偏好 参数 ,并 且 在 应 用 程序 运行 时 使 用 这 些 
参数 。 由 于 这 是 一 个 经 常 性 的 应 用 模式 ,Google 创建 了 一 个 偏好 框架 ,提供 一 种 机 制 使 
开发 者 能 够 很 容易 地 显示 、 保 在 和 操纵 用 户 的 偏好 。 使 用 该 框架 ,在 XML 文件 中 就 可 以 
定义 丰富 的 用 户 界 面 。 可 以 称 这 些 界 面 为 设置 ,用 来 帮助 用 户 选 择 自己 的 偏好 。 

前 面 章节 中 讲述 的 界面 控件 大 多 是 View 类 的 子 类 ,而 设置 界面 是 由 偏好 对 象 构 建 
的 ,都 是 Preference 的 子 类 。 与 View 类 界面 控件 类 似 , 设 置 界 面 通过 XML 文件 定义 不 
同类 型 的 偏好 对 象 。 一 个 偏好 设置 界面 由 一 个 或 多 个 偏好 对 象 组 成 。 每 个 偏好 对 象 就 是 
设置 界面 上 的 一 个 项 目 ,为 用 户 提供 合适 界面 ,改变 偏好 设置 ,例如 CheckBoxPreference 
对 象 是 复 选 框 类 型 的 设置 界面 ;而 ListPreference 提供 了 一 个 单 选 的 模 态 窗 体 。 每 一 个 
偏好 都 以 键 值 对 的 形式 保存 在 应 用 程序 默认 的 Shared Preferences 文件 中 。 当 用 户 改变 
设置 时 ,系统 会 更 新 Shared Preferences 文件 中 对 应 的 值 。 读 取 Shared Preferences 文件 
中 的 数据 ,可 以 根据 用 户 的 共享 参数 改变 应 用 程序 的 行为 。 

1. 使 用 XML 文件 定义 偏好 设置 界面 

新 的 偏好 对 象 可 以 在 运行 时 实例 化 ,也 可 以 在 XML 中 用 偏好 层级 对 象 来 定义 。 使 
用 XML 定义 设置 是 首选 ,因为 XML 文件 结构 更 容易 阅读 ,更 新 也 很 简单 ,并 且 可 以 在 运 
行 时 修改 它们 。 每 一 个 偏好 子 类 都 能 使 用 XML 节点 来 匹配 声明 。Android 系统 预定 义 
了 一 些 偏 好 选项 ,下 面 列 出 一 些 主要 的 选项 。 

。 CheckBoxPreference: 是 一 个 带 有 复 选 框 的 偏好 项 目 ,可 以 用 来 设置 打开 和 关闭 
两 种 状态 ,其 在 Shared Preferences 文件 中 保存 的 值 为 boolean 类 型 ,true 表示 
打开 。 

ListPreference: 是 一 个 带 有 单 选 按钮 的 偏好 选项 ,其 单 选项 列表 会 在 一 个 模 态 窗 
体 中 显示 ,保存 的 值 支持 任何 类 型 。 

EditTextPreference: 是 一 个 带 有 文本 编辑 框 的 偏好 选项 ,其 保存 的 值 为 String 
类 型 。 

RingtonePreference: 用 户 使 用 这 个 偏好 选项 从 设备 上 选择 铃声 ,选中 的 铃声 URI 
会 被 保存 为 String 类 型 。 
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设计 Shared Preferences 设置 界面 的 XML 文件 需要 保存 在 项 目的 res/xml 目录 下 ， 
其 文件 名 可 以 任意 命名 ,但 一 般 都 使 用 preferences. xml 作为 偏好 的 文件 名 。 如 果 要 为 偏 
好 设置 创建 多 面板 布局 , 则 需要 为 每 一 个 Fragment 创建 单独 的 XML 文件 。 

在 偏好 设置 界面 的 XML 文件 中 , 根 节 点 必须 是 一 个 天 PreferenceScreen 二 元素 ,在 
这 个 元 素 中 可 以 定义 多 个 偏好 对 象 。 在 二 PreferenceScreen 之 中 添加 的 每 个 子 元 素 代表 
了 偏好 设置 列表 中 的 一 个 项 目 ,代码 7.2 是 一 个 XML 定义 偏好 设置 的 示 列 代码 。 

代码 7.2 preferences. xml 
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在 代码 7.2 中 使 用 了 CheckBoxPreference、ListPreference 和 Edit TextPrefence 三 种 
偏好 项 目 ,并 使 用 PreferenceCategory 对 偏好 项 目 进行 分 组 。 其 中 包含 的 一 些 属性 解释 
如 下 。 

e android:key, 当 需 要 保存 偏好 项 目的 值 时 ,这 个 属性 是 必需 的 。 这 个 属性 为 每 个 

偏好 对 象 指定 了 唯一 的 key( 一 个 字符 串 类 型 ) , 当 系 统 在 Shared Preferences X 
件 中 保存 偏好 设置 时 ,需要 用 到 这 个 属性 。 

° android :title, 为 偏好 设置 提供 了 一 个 用 户 可 见 的 名 称 。 

。 android:defaultValue, 指 定 初始 值 ,Android 系统 将 其 保存 在 Shared Preferences 

文件 中 。 

应 用 程序 中 的 偏好 设置 可 能 定义 了 一 些 影响 用 户 操作 的 重要 行为 ,所 以 当 用 户 第 一 
次 打开 应 用 程序 时 ,有 必要 为 每 一 个 偏好 设置 项 目 在 Shared Preferences 文件 中 赋予 初 
始 化 默认 值 。 要 实现 这 个 功能 ,首先 必须 在 XML 文件 中 为 每 一 个 偏好 项 目 指定 一 个 默 
认 值 ( 见 代码 7. 3) 。 

代码 7.3 为 偏好 项 目 指定 默认 值 


<CheckBoxPreference 
android:defaultValue="true" 
/> 


<ListPreference 
android:defaultValue="@string/pref_syncConnectionTypes_default" 
/> 


然后 ,在 Activity 里 的 onCreate() 方 法 中 调用 setDefaultValues() 方 法 。 代 码 如 下 : 


PreferenceManager. setDefaultValues (this, R. xml. advanced _ preferences, 
false); 


在 onCreate() 方 法 中 调用 setDefaultValues() 方 法 的 目的 是 为 了 在 应 用 程序 启动 的 
时 候 使 用 默认 设置 初始 化 。 这 个 方法 中 有 三 个 参数 : 第 一 个 参数 为 应 用 程序 的 Context; 
第 二 个 为 偏好 设置 XML 文件 的 资源 ID; 第 三 个 参数 为 boolean 值 ,表示 是 否 多 次 设置 默 
认 值 ,当然 大 部 分 情况 下 默认 值 一 般 只 需要 设置 一 次 , 值 为 false 即 可 。 

e android:summary, 为 偏好 设置 选项 提供 一 个 用 户 可 见 的 摘要 。 

。 android:entries, 只 在 ListPreference 中 使 用 ,用 来 定义 单 选 窗口 中 的 显示 项 目 。 

其 引用 了 一 个 数组 资源 @array/updateInterval( 见 代码 7. 4)。 
代码 7.4 定义 单 选 窗口 的 中 的 显示 项 目 


<string-array name="updateInterval"> 
<item name="1000">1 秒 </item> 
<item name="5000">2 秒 </item> 
<item name="30000"> 30 秒 </item> 


> 





RDZ 基于 Androd 平台 的 移动 互联 网 应 用 开发 (第 = 版) 
= 





<item name="60000">1 分 钟 </item> 
<item name-="300000">2 分 钟 </item> 
</string-array> 


。 android:entryValues, 只 在 ListPreference 中 使 用 ,用 来 定义 选项 的 保存 值 。 其 引 
用 了 另 一 个 数组 资源 @array/updatelIntervalValues( 见 代码 7.5). 
代码 7.5 定义 单 选项 的 保存 值 


<string-array name="updateIntervalValues"> 
<item name="1000">1000</item> 
<item name="5000">5000</item> 
<item name="30000">30000< /item> 
<item name="60000"> 60000< /item> 
<item name="300000">300000</item> 


</string-array> 


为 了 在 Acitivity 中 显示 偏好 设置 ,继承 PreferenceActivity 类 ,基于 偏好 对 象 层级 关 
系 来 显示 一 个 设置 列表 。 当 用 户 做 出 一 个 改变 时 ,PreferenceActivity 能 自动 保存 与 每 一 
个 Preference 相关 的 设置 。 

与 View 类 的 GUI 加 载 不 同 ,在 onCreate() 回 调 方法 中 使 用 addPreferencesFromResource() 
调用 来 添加 所 定义 的 Shared Preferences 设置 界面 XML 文件 ( 见 代 码 7.6). 

代码 7.6 定义 PreferencActivity 子 类 ,引用 偏好 设置 的 XML 文件 


public class QuickPrefsActivity extends PreferenceActivity { 


@override 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
addPreferencesFromResource (R.xm1l.preferences); 


) 


如 果 在 Android 3. 0 或 更 高 版 本 上 开发 ,可 使 用 PreferenceFragment 来 显示 
Preference 对 象 列 表 ,因为 PreferenceFragment 提供 比 PreferenceActivity 更 为 灵活 的 应 
用 程序 结构 。 使 用 PreferenceFragment 需要 首先 定义 一 个 设置 子 类 SettingsFragment， 
然后 将 这 个 Fragment 添加 到 Activity 码 中 ( 见 代码 7.7) 

代码 7.7 设置 子 类 PreferenceFragment ,为 Activity 添加 定义 好 的 偏好 设置 


static class SettingsFragment extends PreferenceFragment { 
@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
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addPreferencesFromResource (R.xm1l.preferences); 


Îi 


public class SettingsActivity extends Activity { 
@override 
protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
getFragmentManager () .beginTransaction() 
.replace (android.R.id.content, new SettingsFragment ()) 
.Commit () 7 


) 


完成 偏好 设置 界面 的 设计 ,运行 应 用 程序 可 以 到 偏好 设置 的 启动 界面 ( 见 图 7. 2 左 
图 )。 然 后 ,选择 “是 否 更 新 ”这 个 偏好 选项 设置 打开 “更 新 间隔 ”设置 界面 ( 见 图 7. 2 中 
图 ) ,可 以 选择 具体 的 更 新 间隔 设置 值 。 这 两 个 设置 界面 之 间 的 依赖 关系 是 一 个 非常 有 用 
的 设 定 ,在 preferences. xml 文件 使 用 android: dependency= "perform_updates" JR PER ¿É 
义 了 两 个 项 目的 依赖 关系 ,这 个 属性 值 指 向 了 “是 否 更 新 "项目 。 

选择 “设置 欢迎 信息 ”, 然 后 会 看 到 对 话 框 ,这 是 一 个 带 有 文本 编辑 框 的 偏好 设置 项 目 
( 见 图 7. 2 右 图 )。 对 于 这 种 偏好 设置 选项 ,其 界面 上 面 的 显示 信息 也 可 用 通过 XML X: 
件 定义 。 在 代码 7.2 preferences. xml 中 ,使 用 android: dialogMessage 属性 设置 对 话 框 
的 提示 信息 ;使 用 android:dialogTitle 属性 设置 对 话 框 的 标题 。 


























更 新 设置 u 
是 否 更 新 加 更 新 间隔 
打开 或 者 关闭 数据 更 新 
ad 欢迎 信息 
更 新 间隔 
定义 数据 更 新 的 时 间 间 隔 | 2 SR 
m | | 到 ° 
| 1 分 钟 
设置 欢迎 信息 | _ 
定义 需要 显示 的 欢迎 信息 z Hello, Mobile World 
| =. 取消 确定 
7.2 偏好 设置 


默认 的 情况 下 ,所 有 应 用 中 的 偏好 都 会 保存 到 一 个 文件 中 ,调用 静态 方法 
PreferenceManager. getDefaultSharedPreferences( ) 能 够 获得 所 保存 的 偏好 值 ,其 返回 一 
个 SharedPreferences 对 象 ,这 个 对 象 中 包含 所 有 我 们 在 PreferenceActivity 中 使 用 的 偏 
好 对 象 的 键 值 对 。 代 码 7. 8 是 从 Shared Preferences 文件 中 读 取 偏 好 项 目 值 的 一 个 简单 
例子 。 
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代码 7.8 从 Shared Preferences 文件 中 读 取 偏好 项 目 值 


SharedPreferences sharedPref = PreferenceManager . getDefaultSharedPreferences 
(this); 


String syncConnPref=sharedPref.getString (SettingsActivity.KEY PREF SYNC_ 
CONN, ""); 


通过 给 偏好 项 目 添加 二 intent 之 元 素 , 可 以 定义 需要 启动 的 Intent, 打 开 一 个 Activity 
或 启动 一 个 服务 ,例如 打开 浏览 器 来 查看 一 个 Web 页 面 ( 见 代码 7. 9) 。 
代码 7.9 为 偏好 项 目 定义 Intent 


<Preference android:title="@ string/prefs web page"> 
<intent android:action="android.intent.action.VIEW" 


android:data="http://www.example.com" /> 
</Preference> 


2. 监听 偏好 项 目的 改变 

在 应 用 程序 运行 过 程 中 ,有 些 情况 下 , 当 Shared Preferences 设置 发 生 改 变 时 ,希望 可 以 
得 到 通知 。 这 个 功能 可 以 使 用 SharedPreference. OnSharedPreferenceChangeListener 这 个 接 
口 来 实现 。 通 过 调用 registerOnSharedPreferenceChangeListener() 方 法 为 SharedPreferences 
对 象 注 册 监 听 器 。 然 后 覆盖 这 个 接口 的 唯一 回调 方法 onSharedPreferenceChanged()。 
通过 实现 这 个 接口 ,可 以 在 任意 一 个 偏好 项 目 发 生 改变 时 ,取得 一 个 回调 。 代 码 7. 10 是 
一 个 简单 的 例子 。 

代码 7.10 定义 偏好 项 目 改变 监听 器 


public class SettingsActivity extends PreferenceActivity implements 
OnSharedPreferenceChangeListener { 


public static final String KEY PREF SYNC CONN="pref syncConnectionType™"; 


public void onSharedPreferenceChanged (SharedPreferences 
sharedPreferences, String key) { 
if(key.equals (KEY PREF SYNC CONN)) { 
Preference connectionPref=findPreference (key); 
// 为 选中 的 值 设置 用 户 描 述 摘要 。 
connectionPref .setSummary (sharedPreferences .getString 
(key, "")); 


) 


代码 7. 10 中 ,onSharedPreferenceChanged() 方 法 会 检测 改变 的 设置 是 否 为 一 个 已 
知 的 preference key。 如 果 是 ,就 会 调用 findPreference() 来 获得 改变 后 的 Preference 对 
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象 ,针对 其 给 出 所 需要 的 处 理 。 这 里 设置 了 一 个 摘要 ,用 于 当 用 户 选 中 时 给 出 提示 信息 。 
其 实 这 是 一 个 比较 好 的 方法 ,特别 是 多 个 被 选中 时 ,可 以 通过 现 有 的 API 让 用 户 知道 他 
们 做 了 些 什么 并 得 到 反馈 。 

要 让 监听 器 起 作用 ,还 需要 在 Activity 声明 周期 中 的 onPause() 和 onResume() 方 法 
中 注册 和 注销 的 监听 器 , 见 代 码 7. 11。 

代码 7.11 注册 和 注销 监听 器 


@override 
protected void onResume () { 
super.onResume () 7 
getPreferenceScreen () .getSharedPreferences () 
.registerOnSharedPreferenceChangeListener (this); 
) 


@override 
protected void onPause() { 
super.onPause (); 
getPreferenceScreen () .getSharedPreferences () 
.unregisterOnSharedPreferenceChangeListener (this); 


7.3 文件 读 取 与 保存 


在 应 用 程序 保存 文件 有 两 个 目的 。 一 种 目的 只 是 针对 某 种 应 用 使 用 ,不 能 被 其 他 应 
用 使 用 ,其 为 私有 文件 ,例如 电子 阅读 应 用 使 用 的 文件 具有 特殊 的 格式 ,只 能 被 电子 阅读 
应 用 使 用 。 另 外 一 种 目的 不 是 针对 特定 应 用 的 ,可 以 被 其 他 应 用 使 用 ,其 为 公共 文件 , 例 
如 照相 机 产生 的 图 片 文件 ,可 以 被 图 像 编辑 应 用 或 者 其 他 应 用 使 用 。 当 需要 对 文件 操作 
时 ,要 根据 这 两 个 目的 正确 选择 内 部 存储 或 是 外 部 存储 。 一 般 来 说 应 用 程序 都 会 使 用 两 
种 文件 夹 ,一 种 是 在 内 部 存储 上 ,用 来 保存 私有 数据 ;还 有 一 种 是 在 扩展 存储 上 ,用 来 保存 
公共 数据 。 

当然 ,应 用 程序 的 私有 数据 也 可 以 保存 在 扩展 存储 上 。 扩 展 存储 一 般 是 可 移动 的 存 
储 介质 ,而 且 缺 少 安全 保护 ,所 以 可 以 用 来 保存 公共 数据 。 移 动 设 备 的 内 部 存储 由 生产 厂 
商 固 化 在 设备 上 ,其 存储 空间 是 受到 限制 的 ,一 般 不 会 很 大 ,而 且 不 能 扩展 。 所 以 ,需要 考 
虑 将 一 些 文件 保存 在 扩展 存储 上 。 具 体 哪 些 文件 保存 在 扩展 存储 上 ,与 文件 的 大 小 和 用 
途 等 多 个 方面 的 因素 有 关 。 


731 内 部 存储 


前 面 学 习 的 Shared Preferences, 主要 存储 的 数据 类 型 是 键 值 对 ,用 于 存储 简单 的 信 
息 。 而 对 于 按 顺 序 读 写 的 大 数据 ,例如 读 写 镜 像 文 件 或 基于 网 络 的 数据 交换 ,Android 使 
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用 的 文件 系统 与 其 他 平台 的 基于 磁盘 的 文件 系统 类 似 。 本 节 和 下 一 节 主 要 介绍 如 何 使 用 
File APIs 在 Android 的 存储 区 域 中 来 执行 读 写 Android 文件 系统 的 操作 。 

所 有 的 Android 设备 都 有 两 个 文件 存储 区 域 : 内 部 (Internal) 和 外 部 (External) 存 储 
器 。 这 两 个 名 称 来 自 早期 的 Android, 当时 大 多 数 设备 都 提供 内 置 的 固定 的 内 存 ( 内 置 存 
储 器 ), 外 加 一 个 可 移动 的 存储 介质 ,如 micro SD 卡 (外 部 存储 器 )。 有 些 设备 把 固定 不 变 
的 存储 空间 分 成 内 部 和 外 部 两 部 分 ,这 样 即 使 没有 可 移动 的 存储 介质 ,也 总 会 有 两 个 存储 
空间 ,并 且 不 管 外 部 存储 器 是 可 移动 的 ,还 是 固定 的 ,API 的 使 用 方法 是 相同 的 。 

Android 的 内 部 存储 器 与 外 部 存储 器 各 自 具有 不 同 的 特点 ,可 以 根据 应 用 程序 的 数 
据 存储 要 求 ,选择 将 文件 存储 到 合适 的 存储 区 域 。 表 7. 1 是 它们 的 特点 对 比 。 


表 7.1 Android 的 内 部 存储 器 和 外 部 存储 器 特点 对 比 








内 部 存储 名 外 部 存储 器 
并 非 始终 可 访问 ,因为 用 户 可 能 安装 USB 之 类 的 存储 
Sena i 介质 ,有 时 会 印 载 
默认 情况 下 存储 的 文件 只 能 自己 的 应 用 可 | 是 无 限制 可 读 的 ,因此 存储 的 文件 可 能 会 被 外 界 应 用 
以 访问 读 取 ,不 可 控制 





当 用 户 印 载 应 用 程序 后 , 系统 也 会 删除 此 应 用 程序 ， 
要 确保 文件 不 被 其 他 用 户 或 应 用 访问 ,内 部 | 使 用 gerExternalFilesDir 〇 保存 的 文件 


存储 是 最 好 的 对 于 希望 与 其 他 应 用 共享 .不 需要 访问 限制 的 文件 来 
说 ,外 部 存储 是 最 好 的 








内 部 存储 器 (Internal Storage) ,就 是 将 文件 保存 在 设备 内 部 存储 器 中 。 默 认 情况 下 ， 
这 些 文件 是 相应 程序 私有 的 ,对 其 他 程序 不 透明 ,对 用 户 也 是 不 透明 的 。 当 程序 印 载 后 ， 
这 些 文件 就 会 被 删除 。 在 内 部 存储 器 上 保存 数据 时 ,不 需要 设置 任何 权限 ,应 用 程序 始终 
有 权 读 写 它 在 内 部 存储 器 目录 中 保存 的 文件 。 

Android SDK 提供 的 文件 存储 权限 如 下 : 

。 Context. MODE_APPEND ,追加 方式 存储 ; 

。 Context. MODE_PRIVATE ,私有 方式 存储 ,其 他 应 用 无 法 访问 ; 

。 Context. MODE_WORLD_READABLE ,允许 其 他 应 用 读 取 数据 ; 

。 Context. MODE_WORLD_WRITEABLE, 允许 其 他 应 用 写 入 、 读 取 数 据 。 

应 用 程序 的 内 部 存储 目录 是 在 Android 文件 系统 的 特定 位 置 ,是 由 应 用 程序 的 包 名 
称 来 指定 的 。 从 技术 上 来 说 ,如 果 你 把 该 文件 模式 设置 为 可 读 的 ,那么 另外 一 个 应 用 程序 
是 可 以 读 取 你 的 内 部 文件 的 。 但 是 ,其 他 的 应 用 程序 还 需要 知道 你 的 应 用 程序 的 包 名 和 
文件 名 。 然 而 其 他 的 应 用 程序 不 能 浏览 你 的 应 用 程序 内 部 目录 ,而 且 需 要 把 该 文件 设置 
为 可 读 或 可 写 ,这 样 ,其 他 应 用 程序 对 该 文件 的 读 写 条 件 相当 严格 。 因 此 在 内 部 存储 器 
上 ,只 要 你 的 文件 使 用 了 MODE_PRIVATE 模式 ,那么 其 他 的 应 用 程序 就 不 会 访问 到 
它们 。 

一 般 来 说 ,作为 应 用 程序 私有 的 文件 需要 保存 在 内 部 存储 上 。 例 如 这 些 文件 可 能 是 
下 载 的 杂志 ,数据 文件 等 ,将 它们 看 作 是 应 用 程序 的 一 部 分 。 默 认 情 况 下 ,保存 在 内 部 存 


第 7 章 ， 实 现 数据 的 存储 


储 上 的 文件 是 应 用 程序 的 私有 数据 ,其 他 应 用 程序 不 能 够 访问 它们 。 这 些 文件 存放 在 应 
用 程序 的 安装 文件 夹 中 ,并 且 遵 守 一 定 的 命名 规则 。 当 用 户 印 载 应 用 程序 时 ,这 些 文件 也 
会 被 删除 ,这 样 符合 Android 数据 的 清理 机 制 。 

在 内 部 存储 器 中 创建 并 保存 数据 文件 ,可 以 按照 以 下 步骤 来 做 : 

(1) 使 用 FileOutputStream 对 象 ,调用 openFileOutput() 方 法 ,参数 分 别 为 文件 名 、 
操作 模式 ,返回 值 是 一 个 FileOutputStream 。 

(2) 使 用 write() 方 法 向 文件 中 写 人 数据 。 

(3) 调用 close() 方 法 ,关闭 输出 流 。 

相关 代码 见 代 码 7. 12。 

代码 7.12 使 用 内 部 存储 保存 文件 


String FILENAME="hello_file"; 
String string= "hello world!"; 


FileOutputStream fos=openFileOutput (FILENAME, Context.MODE_PRIVATE); 
fos.write(string.getBytes()); 
fos.close(); 


openFileOutput() 方 法 中 的 参数 FILENAME 用 于 指定 文件 名 称 ,不 能 包含 路 径 分 
隔 符 “/”, 如 果 文 件 不 存在 ,Android 会 自动 创建 它 。 创 建 的 文件 保存 的 目录 为 : 


/data/data/<package name>/files/ 


例如 ,/data/data/com. google. sample/files/hello _ file, “/data/data/com. google. 
sample/ ”是 应 用 程序 安装 时 自动 产生 的 目录 ,用 来 保存 应 用 程序 的 私有 数据 。 其 中 files 
是 一 个 子 目录 用 来 保存 文件 ,还 有 可 能 有 databases(SQLite 数据 库 ) ,shared_prefs( 共 享 
引用 ) cache( 缓 存 的 文件 和 数据 ) 和 lib( 本 地 库 ) 。 

openFileOutput() 方 法 的 第 二 个 参数 代表 文件 读 写 模 式 。 在 代码 7. 12 中 ,MODE_ 
PRIVATE 表示 要 创建 一 个 新 文件 。 如 果 有 同名 文件 存在 , 则 会 替换 旧 文件 ,并且 这 个 文 
件 是 应 用 程序 的 私有 文件 。 其 他 可 用 的 模式 还 包括 : 

。 MODE_APPEND: 表示 只 有 创建 此 文件 的 程序 能 够 使 用 ,其 他 应 用 程序 不 能 访 

问 。 如 果 目 录 中 有 同名 文件 , 则 在 原 有 内 容 基 础 上 增加 数据 ; 

* MODE_WORLD_READABLE: 表示 可 以 被 其 他 应 用 程序 读 取 ; 

。 MODE_WORLD_WRITEABLE: 表示 可 以 被 其 他 应 用 程序 写 入 。 

这 几 个 文件 读 写 模式 是 Android 定义 的 常数 , 值 均 为 整 型 数字 ,因此 可 以 使 用 “|” 符 
号 将 它们 连接 起 来 。 下 面 的 代码 是 一 个 简单 的 例子 。 


openFileOutput (FILENAME, 
Context .MODE APPEND | Context .MODE WORLD READABLE); 


这 段 代码 表示 创建 的 文件 可 以 被 其 他 应 用 程序 读 取 , 而 且 , 如 果 原 来 目录 中 有 同名 文 
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件 , 则 在 原 有 文件 的 基础 上 增加 数据 。 

如 果 从 内 部 存储 中 读 取 一 个 文件 ,需要 调用 openFileInput() 方 法 ,把 要 读 取 的 文件 
名 传递 给 这 个 方法 。 具 体 步 又 如 下 : 

(1) 调用 openFileInput ( ) 方法 ,参数 为 即将 读 取 的 文件 名 ,该 方法 返回 一 个 
FileInputStream 。 

(2) 调用 read() 方 法 读 取 字 节 。 

(3) 调用 close() 方 法 关闭 输入 流 。 

实现 代码 见 代 码 7.13, 

代码 7.13 读 取 内 部 存储 的 文件 


String FILENAME="hello_file"; 


FileInputStream fis=openFileInput (FILENAME) ; 
byte[] input=new byte [fis.available()]; 

while (fis.read(input) !=-1)() 

String str=new String(input); 

fis.close(); 


内 部 存储 中 设置 的 /data/data/ 二 package name>/cache 目录 用 于 放置 临时 缓存 文 
件 。 对 于 一 些 只 需 临 时 缓存 的 数据 ,可 以 使 用 Content 类 的 getCacheDir() 方 法 来 打开 一 
个 File 对 象 ,对 这 个 目录 进行 操作 。 如 果 需 要 自己 创建 缓存 文件 ,可 以 使 用 
createTempFile( ) 方 法 创建 。 例 如 代码 7. 14 中 的 方法 实现 了 简单 的 文件 读 取 和 临时 组 
存 的 功能 ,首先 获取 文件 名 ,然后 将 其 保存 在 内 部 存储 的 缓存 中 。 

代码 7.14 文件 读 取 和 临时 缓存 


public File getTempFile (Context context, String url) { 

File file; 

try { 
String fileName=Uri.parse (url) .getLastPathSegment (); 
file=File.createTempFile (fileName, null, context.getCacheDir()); 

catch (IOException e) { 
//Error while creating file 

$ 

return file; 


} 


当 设备 的 内 部 存储 空间 不 足 时 ,Android 可 能 会 删除 这 些 缓存 文件 来 回收 存储 空间 , 
但 是 ,最 好 不 要 依赖 系统 来 给 自动 清理 这 些 文件 ,应 该 自己 来 维护 缓存 文件 ,把 存储 空间 
的 耗费 限定 在 合理 的 范围 内 ,如 1MB。 当 用 户 秃 载 应 用 程序 时 ,这 些 文件 会 被 删除 。 
Context 类 还 提供 了 其 他 一 些 操作 目录 和 文件 有 用 的 方法 ,其 中 包括 : 
。 getFileDir(): 获取 保持 内 部 文件 的 绝对 路 径 ,目录 的 格式 为 /data/data/ 
<package name> /files; 


第 7 章 ” 实 现 数据 的 存储 


。 getDir() : 在 内 部 存储 空间 中 创建 或 打开 一 个 目录 ; 

。 deleteFile() : 删除 保存 在 内 部 存储 空间 上 的 文件 ; 

。fieList() : 返回 当前 保存 在 应 用 程序 中 的 文件 数组 列表 。 

为 了 避免 出 现 IOException ,通常 调用 getFreeSpace() 和 getTotalSpace() 方 法 来 分 
别 获 取 存 储 器 的 当前 剩余 的 空间 和 总 空间 大 小 。 当 然 也 不 是 必须 要 调用 这 些 方法 , 另 一 
种 方式 是 可 以 在 写 人 文件 时 捕获 IOException 异常 来 解决 。 

在 应 用 程序 设计 中 ,注意 调用 delete() 方 法 清理 不 需要 的 文件 。 如 果 文 件 位 于 内 部 
存储 器 上 ,可 以 通过 Context 来 定位 ,调用 deleteFile() 方 法 来 删除 该 文件 。 当 用 户 印 载 
掉 应 用 程序 时 ,所 有 保存 在 内 部 存储 器 上 的 文件 ,以 及 通过 getExternalFilesDir() 方 法 保 
存在 外 部 存储 器 上 的 文件 都 将 被 删除 。 而 通过 getCacheDir() 方 法 生成 的 临时 文件 ,需要 
手动 删除 。 


7.3.2 扩展 存储 


每 个 Android 兼容 的 设备 都 支持 共享 的 扩展 存储 器 ,用 于 保存 文件 。 这 个 存储 器 可 
以 是 一 种 可 移动 的 存储 介质 (例如 SD 卡 ); 或 者 是 
不 可 移动 的 存储 器 ,被 固化 在 设备 里 ,但 是 容量 要 
比 内 部 存储 大 得 多 。 保 存在 扩展 存储 上 的 文件 是 
完全 共享 的 ,并 且 在 启用 了 USB 存储 把 文件 传输 
到 计算 机 上 时 ,用户 能 够 修改 这 些 文件 。 

如 果 用 户 将 扩展 存储 挂 载 到 计算 机 上 ( 见 
图 7.3) 或 者 移 除 了 这 个 存储 介质 ,那么 手机 设备 
将 禁止 使 用 扩展 存储 。 这 些 保 存在 扩展 存储 器 上 
的 文件 没有 安全 方面 的 限制 ,所 有 的 应 用 程序 都 能 图 7.3 提示 USB 存储 设备 装载 
够 读 写 放 在 扩展 存储 器 上 的 文件 ,而 且 用 户 也 能 够 
删除 它们 。 

如 果 要 将 文件 保存 在 扩展 存储 上 ,首先 必须 获得 扩展 存储 的 权限 。 要 想 获得 写 人 外 
部 存储 器 的 权利 ,需要 在 Manifest 文件 中 取得 WRITE_EXTERNAL_STORAGE 权限 。 
例如 : 








<uses-permission android:name="android.permission .WRITE EXTERNAL 
STORAGE" /> 


目前 来 说 ,所 有 应 用 程序 都 有 读 取 扩展 存储 的 权限 ,而 不 需 特 别 的 权限 申明 权限 。 如 
果 需 要 特别 申明 对 扩展 存储 的 读 权限 ,可 以 指定 READ _EXTERNAL_STORAGE 权限 。 
当 指 定 了 WRITE_EXTERNAL_STORAGE 权限 ,默认 具有 READ_ EXTERNAL_ 
STORAGE 的 权限 。 

对 于 内 部 存储 ,没有 必要 申明 权限 ,因为 应 用 程序 对 其 在 内 部 存储 上 私有 目录 默认 就 
有 读 写 的 权限 。 

在 使 用 扩展 存储 之 前 ,需要 调用 Environment 类 的 getExternalStorageState( ) 方 法 
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来 检查 存储 介质 是 否 可 用 。 存 储 介质 可 能 处 于 被 挂 载 到 计算 机 上 、 丢 失 、 只 读 或 者 其 他 状 
态 ( 见 代码 7. 15) 。 
代码 7.15 扩展 存储 可 用 性 检查 


boolean mExternalStorageAvailable=false; 
boolean mExternalStorageWriteable=false; 
String state=Environment.getExternalStorageState(); 


if (Environment .MEDIA MOUNTED .equals (state)) { 
//We can read and write the media 
mExternalStorageAvailable=mExternalStoragewWriteable=true; 
} else if (Environment .MEDIA MOUNTED READ ONLY.equals(state)) { 
//We can only read the media 
mExternalStorageAvailable=true; 
mExternalStorageWriteable=false; 
)else ( 
//Something else is wrong. It may be one of many other states, but all 
we need 
//to know is we can neither read nor write 
mExternalStorageAvailable=mExternalStorageWriteable=false; 
) 


这 个 例子 检查 了 外 部 存储 器 是 否 可 用 于 读 和 写 。getExternalStorageState() 方 法 还 
可 以 用 来 检查 其 他 状态 ,例如 存储 介质 是 否 被 共享 (连接 到 一 个 计算 机 上 ) ,是 否 完全 丢 
失 、 是 否 被 恶意 地 移 除 等 。 在 应 用 程序 需要 访问 存储 介质 时 ,要 随时 获取 这 些 状态 ,以 便 
给 用 户 提供 更 多 的 通知 信息 。 

如 果 使 用 API 级 别 8 (Froyo Android 2. 2) 或 更 高 的 版 本 ,可 以 使 用 
getExternalFilesDir() 方 法 来 打开 一 个 File 对 象 , 获 取保 存 文件 的 扩展 存储 目录 。 这 个 方 
法 的 第 一 个 参数 指定 了 所 需 的 子 目录 类 型 。 如 果 此 目录 类 型 参数 值 为 null 值 , 则 返回 应 
用 程序 在 扩展 存储 中 保存 文件 的 如 下 根 目 录 。 代 码 如 下 : 


storage/cdcard0/Android/data/<package name>/files/ 


<package_ name > $Æ Java 样式 的 包 名 , 如 : com. example. android. app。 这 是 
Android 4. 2. 2 的 目录 结构 ,不 同 版 本 目录 结构 可 能 不 一 样 。 使 用 Environment 类 中 的 
目录 常量 可 以 避免 格式 不 同 的 问题 ,能 够 很 好 地 来 传递 根 目录 下 子 目录 的 值 。 例 如 
DIRECTORY_MUSIC 和 DIRECTORY_RINGTONES 常量 分 别 对 应 上 述 文件 根 目录 中 
的 Music 和 RingTones 子 目录 ,代码 如 下 : 


Pile file=new Pile ( 
context.getExternalFilesDir (Environment.DIRECTORY PICTURES), 
albumName) ; 
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这 个 方法 会 创建 与 系统 规范 一 致 的 目录 结构 。 通 过 指定 目录 的 类 型 ,确保 Android 
系统 的 介质 扫描 器 对 文件 进行 正确 的 分 类 。 当 用 户 的 设备 正在 运行 API 级 别 8 或 更 高 
的 版 本 ,如 果 外 载 了 应 用 程序 ,那么 这 个 目录 和 其 所 有 的 内 容 将 会 被 删除 。 

如 果 使 用 API 级别 7 或 更 低 的 API 版 本 ,可 以 使 用 getExternalStorageDirectory() 
方法 来 打开 一 个 File 对 象 ,获取 扩展 存储 的 根 目录 。 代 码 如 下 : 


File file=new File ( 
Environment.getExternalStorageDirectory(), albumName); 


但 是 如 果 使 用 这 种 方法 , 4 W HIR2R a X 4- H 82 RR 2 fE B 3: F t FREZI 
圾 目录 。 

如 果 保 存 的 文件 不 是 应 用 程序 私有 的 ,在 应 用 程序 被 印 载 时 需要 保留 ,存储 的 位 置 则 
要 放 到 扩展 存储 上 的 公共 目录 中 。 这 些 目录 位 于 外 部 存储 器 的 根 目 录 , 如 Music/、 
Pictures/、Ringtones/ 等 。 

在 API 级 别 8 或 更 高 的 版 本 中 ,可 以 使 用 getExternalStoragePublicDirectory () 方 
法 ,参数 的 传递 与 getExternalFilesDir ( ) 方 法 类 似 。 对 于 临时 文件 , 可 以 使 用 
getExternalCacheDir() 方 法 来 打开 一 个 File 对 象 , 则 在 扩展 存储 目录 中 保存 缓存 文件 。 
如 果 镍 载 应 用 程序 ,这 些 文件 会 自动 被 删除 。 但 是 ,在 应 用 的 生存 期 间 , 应 该 自己 管理 这 
些 缓存 文件 ,不 需要 的 时 候 删 除 这 些 缓存 文件 。 缓 存 数据 被 写 和 人 下列 目 录 中 : 


storage/cdcard0/Android/data/<package name>/cache/ 
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Android 系统 可 以 定义 三 种 作为 资源 的 文件 ,它们 分 别 保存 在 三 个 不 同 资源 目录 中 ， 
分 别 为 : /res/xml、/res/raw 和 /assets。 

发 布 应 用 时 ,如 果 要 把 一 个 静态 文件 保存 到 应 用 程序 的 发 布 包 中 ,就 要 把 这 个 文件 保 
存在 项 目的 res/raw/ 目 录 中 。 使 用 openRawResource() 方 法 可 以 打开 /res/raw/ 目 录 中 
的 静态 文 fF, 这 个 方法 需要 把 R. raw. < filename 之 的 资源 ID 传递 给 它 。 
openRawResource() 方 法 会 返回 一 个 用 于 读 取 文件 的 InputStream 对 象 ,但 是 不 能 对 这 
个 文件 进行 写 人 操作 。 

/res/xml 资源 目录 可 以 用 来 存储 XML 格式 的 文件 ,并 且 和 其 他 资源 文件 一 样 , 这 里 
的 资源 是 会 被 编译 成 二 进 制 格式 放 到 最 终 的 安装 包 里 的 ,通过 R 类 能 够 访问 XML 文件 
的 资源 ID ,并 且 解 析 里 面 的 内 容 。 例 如 ,/res/xml 中 存放 了 一 个 名 为 data. xml 的 文件 
( 见 代码 7. 16) 。 

代码 7. 16 data. xml 


<?xml version="1.0" encoding="utf-8"?> 
<book> 

<title> 移 动 电子 商务 </title> 
</book> 
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然后 ,就 可 以 通过 资源 ID 来 访问 并 解析 这 个 文件 了 ( 见 代 码 7. 17) 。 
代码 7.17 使 用 PULL 的 方法 解析 XML 文件 


XmlResourceParser xml=getResources () .getXml (R.xml.data); 
try { 
int eventType=xml.getEventType (); 
boolean inTitle=false; 


while (eventType !=XmlPullParser.END_DOCUMENT) { 


// 到 达 title 节点 时 标记 一 下 
if (eventType==XmlPullParser.START TAG) { 
if (xml.getName () .equals ("title")) { 


inTitle=true; 


} 
// 如 果 到 达标 记 的 节点 则 取出 内 容 
if (eventType==XmlPullParser.TEXT && inTitle) { 
((TextView) findViewById(R.id.title)) 
.SetText (xml.getText ()); 
} 
eventType=xml.next (); 
} 
} catch (XmlPullParserException e) { 
//TODO Auto-generated catch block 
e.printStackTrace () 7 
) catch (IOException e) { 
//TODO Auto-generated catch block 
e.printStackTrace (); 
} 


代码 7.17 中 ,使 用 Resources 类 的 getXml() 方 法 返回 一 个 XML 文件 的 PULL 解析 
器 。/res/xml 的 XML 文件 会 被 编译 成 二 进 制 形式 。 如 果 想 让 文件 原样 存储 ,必须 要 存 
储 到 /res/raw 资源 子 目录 中 ,这 个 目录 可 以 原封 不 动 地 将 文件 存储 到 设备 上 ,不 会 被 编 
译 为 二 进 制 形式 ,访问 的 方式 也 是 通过 R 类 获得 资源 ID. 

修改 代码 7.17 中 的 第 一 句 , 使 用 openRawResource() 方 法 获取 资源 ( 见 代码 7.18). 

代码 7.18 使 用 openRawResource() 方 法 获取 raw 资源 





XmlPullParser xml=Xml.newPullParser(); 
InputStream in=getResources().openRawResource (R.raw.data); 
xml .SetInput (new StringReader (in.toString ())); 























代码 7.18 使 用 Resource 类 中 的 openRawResource 方法 ,返回 一 个 输入 流 。 通 过 对 
输入 流 的 操作 ,就 可 以 任意 读 取 文 件 中 的 内 容 了 。 
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如 果 需 要 更 高 的 自由 度 , 尽 量 不 受 Android 系统 的 约束 ,那么 可 以 选择 使 用 /assets 
资源 子 目 录 。 这 个 目录 中 的 文件 除了 不 会 被 编译 成 二 进 制 形式 之 外 ,另外 一 点 就 是 访问 
方式 是 通过 文件 名 ,而 不 是 资源 ID。 并 且 还 有 更 重要 的 一 点 就 是 ,可 以 在 这 里 任意 地 建 
立 子 目录 ,而 /res 目录 中 的 资源 文件 是 不 能 自行 建立 子 目录 的 。 

使 用 这 种 灵活 的 资源 存储 方式 实现 相同 的 功能 ( 见 代 码 7. 19) 。 

代码 7.19 访问 /assets 文件 资源 


XmlPullParser xml=Xml.newPullParser(); 
RssetManager asset=getAssets (); 

InputStream in=asset.open("data.xml"); 
xml.setInput (new StringReader(in.toString())); 


代码 7. 19 中 ,使 用 Context 类 的 getAssets 方法 ,返回 一 个 AssetManager 对 象 ; 然 后 
使 用 open() 方 法 就 可 以 访问 需要 的 资源 了 ,这 里 open() 方 法 是 打开 assets 目录 中 的 文 
件 ,这 是 Android 项 目 资源 文件 的 根 目 录 。 所 以 上 面 这 段 代码 访问 的 是 assets 目录 中 名 
为 data. xml 文件 资源 。 


7.4 存 取 结 构 化 数据 


Android 中 通过 SQLite 数据 库 引擎 来 实现 结构 化 数据 存储 。Android 系统 提供 了 
对 SQLite 数据 的 完全 支持 ,目前 支持 的 版 本 为 SQLite 3. 9。 

Android 系统 通过 SQLiteDatabase 类 来 对 SQLite 数据 库 进 行 访问 ,该 类 封装 了 一 
些 操作 数据 库 的 API, 使 用 该 类 可 以 完成 对 SQLite 中 数据 进行 添加 (Create)、 查 询 
(Retrieve) 、 更 新 (Update) 和 删除 (Delete) 操 作 。 


7.4.1 SQLite 简介 


SQLite 是 一 款 开 源 的 、. 轻 量 级 的 .嵌入 式 的 关系 型 数据 库 。 它 在 2000 年 由 D. 
Richard Hipp 发 布 ,可 以 支援 Java、. NET, PHP, Ruby, Python, Perl, C 等 几乎 所 有 的 现 
代 编 程 语言 ,支持 Windows, Linux, UNIX, Mac OS, Android, IOS 等 几乎 所 有 的 主流 操 
作 系 统 平台 。 目 前 发 布 的 版 本 是 SQLite 3. 18.0, 简 称 SQLite 3, 

SQLite 是 一 个 嵌入 式 SQL 数据 库 引 擎 ,实现 了 一 个 自 包 含 的 、 无 服务 器 、 零 配置 . 事 
务 性 的 SQL 数据 库 , 能 够 针对 内 存 等 资源 有 限 的 设备 (如 手机 、PDA、MP3) 提 供 一 种 高 
效 的 数据 库 引 擎 。 目 前 ,SQLite 是 部 署 最 广泛 的 在 世界 上 的 SQL 数据 库 引 擎 。 

SQLite 具有 以 下 特点 : 

° 事务 处 理 是 原子 的 一 致 的 ,独立 的 和 持久 的 (ACID)。 

。 零 配 置 , 即 不 需要 设置 和 管理 。 
实现 了 绝 大 部 分 的 SQL92 标准 。 

一 个 单独 的 跨 平台 的 磁盘 文件 存储 一 个 完整 的 数据 库 。 
支持 TB 大 小 数据 库 、G 级 别 的 串 和 二 进 制 大 对 象 。 
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。 小 于 500KB 的 代码 运行 代码 空间 。 

。 对 于 绝 大 多 数 普 通 操作 来 说 , 比 流行 的 C/S 模式 的 数据 库 引 擎 运行 速度 快 。 

。 API 简单、 易 用 。 

。 自 包 含 ,没有 外 部 依赖 性 。 

。 跨 平台 ,支持 UNIX (Linux, Mac OS-X, Android, iOS) and Windows (Win32， 

WinCE,WinRT) 。 

SQLite 与 大 多 数 其 他 SQL 数据 库 不 同 ,SQLite 没有 独立 的 服务 器 进程 ,而 是 直接 
对 普通 的 磁盘 文件 进行 读 取 和 写 人 。 一 个 包含 多 个 表 、 索 引 、 和 触发 器 和 视图 的 完整 
SQLite 数据 库 , 全 包含 在 一 个 单一 的 磁盘 文件 中 。 其 数据 库 文件 的 格式 是 跨 平台 的 ,可 
以 在 32 位 和 64 位 系统 之 间或 big-endian 和 little-endian 体系 结构 之 间 进 行 任意 复制 。 
SQLite 的 这 些 特 点 使 其 成 为 应 用 文件 格式 的 一 个 普遍 选择 。 

SQLite 由 以 下 几 个 组 件 组 成 : SQL 编译 器 内核. 后 端 以 及 附件 ( 见 图 7. 4)。 
SQLite 通过 利用 虚拟 机 和 虚拟 数据 库 引 擎 (VDBE) ,使 调试 .修改 和 扩展 SQLite 的 内 核 


变 得 更 加 方便 。 
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图 7.4 SQLite 的 组 成 


SQLite 3 采用 动态 类 型 ,支持 五 种 存储 的 数据 类 型 ,包括 空 值 (NULL)、 整 型 
(INTEGER) , 浮 点 数 (REAL) ,字符 串 (TEXT) 和 大 数据 (BLOB) 数 据 类 型 。 虽然 它 支持 
的 类 型 虽然 只 有 五 种 ,但 也 能 够 接受 VARCHAR(n)、CHAR(n)、DECIMAL(p,s) 等 数 
据 类 型 的 数据 ,只 是 在 运算 或 保存 时 会 转 成 对 应 的 五 种 数据 类 型 。 

在 SQLite 3 中 并 没有 设 定 BOOLEAN 和 DATE 类 型 ,BOOLEAN 型 的 数据 使 用 
INTEGER 的 0 和 1 代替 true 和 false 来 表达 , DATE 类 型 使 用 特定 格式 的 TEXT, 
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REAL 和 INTEGER 的 值 来 代替 显示 。 为 了 方便 DATE 类 型 的 操作 ,SQLite 提供 了 一 
组 函数 ,详细 的 使 用 说 明 可 以 参见 http://www. sqlite. org/lang_datefunc. html。 这 样 简 
单 的 数据 类 型 设计 更 加 符合 嵌 人 式 设 备 的 要 求 。 

SQLite 3 的 动态 类 型 特点 : 不 会 强制 数据 类 型 约束 ,任何 类 型 的 数据 可 以 保存 到 任 
何 字段 中 ,无 论 这 列 声明 的 数据 类 型 是 什么 。 例 如 ,可 以 在 整 型 字段 中 存放 字符 串 , 或 者 
在 布尔 型 字段 中 存放 浮 点 数 ,或 者 在 字符 型 字段 中 存放 日 期 型 值 。 但 有 一 种 情况 例外 , 定 
XA INTEGER PRIMARY KEY 的 字段 只 能 存储 64 位 整数 , 当 向 这 种 字段 中 保存 除 整 
数 以 外 的 数据 时 ,将 会 产生 错误 。 

SQLite 遵从 标准 的 SQL 语句 ,常用 的 SQL 语句 语法 如 下 : 

DEWE., 


SELECT * FROM 表 名 WHERE 条 件 表达 式 GROUP BY 分 组 字句 HAVING … ORDER BY 排序 子 句 
(2) 插入 语句 。 

INSERT INTO 表 名 (字段 列表 ) VALUES ( 值 列 表 ) 
(3) 更 新 语句 。 

UPDATE & £ SET 字段 = 表达 式 [, 字 段 = 表达 式 … ] WHERE 条 件 表达 式 
(4) 删除 语句 。 

DELETE FROM 表 名 WHERE 条 件 表达 式 


值得 注意 的 是 ,SQLite 不 支持 一 些 标准 的 SQL 功能 ,特别 是 外 键 约束 (FOREIGN 
KEY Constrains) Æ Transaction, RIGHT OUTER JOIN 和 FULL OUTER JOIN ,还 
有 一 些 ALTER TABLE 功能 。 

SQLite 是 一 个 紧缩 库 。 如 果 具 有 所 有 的 功能 ,依赖 目标 平台 和 编译 优化 的 设置 , 库 
的 大 小 可 以 不 超过 500KB,64 位 的 可 能 会 大 一 些 。 如 果 可 选 的 一 些 功能 省 略 ,SQLite 大 
小 可 以 低 于 300KB。SQLite 可 以 运行 于 最 小 栈 空 间 4KB 和 堆 空间 100KB 的 环境 中 ,这 
一 优势 ,使 SQLite 在 内 存 受 限 的 嵌入 式 领 域 得 到 广泛 应 用 。Android 也 直接 采用 了 
SQLite 数据 库 作为 结构 化 存储 结构 。 

Android 系统 为 SQLite 数据 库 的 操作 提供 了 android. database. sqlite 包 , 用 于 进行 
SQLite 数据 库 的 添加 、 删 除 、 修 改 和 查询 操作 ,对 应 用 中 所 创建 结构 化 数据 操作 提供 
API, 包 括 SQLiteDataBase 和 SQLiteOpenHelper 等 类 。Android 系统 还 提供 了 关系 数 
据 库 的 管理 功能 ,作为 支持 SQLite 数据 库 系 统 的 一 部 分 ,通过 这 些 功能 可 以 存 取 其 中 的 
复杂 数据 集 。SQLite 的 数据 库 文件 存储 的 目录 为 “/data/data/package _ name/ 


databases”。 


7.4.2 创建 SQLite 数据 库 
默认 情况 下 ,Android 系统 下 的 SQLite 不 具有 创建 和 管理 数据 库 的 管理 接口 或 应 
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用 ,因此 需要 通过 编码 来 创建 数据 库 。 首 先 需 要 创建 一 个 SQLiteOpenHelper 类 的 子 类 
来 处 理 数据 库 所 有 的 操作 ,例如 创建 数据 库 、 创 建 表 、 插 入 和 删除 记录 等 。 
SQLiteOpenHelper 提供 有 两 个 方法 来 操作 数据 库 : 
。 onCreate(SQLiteDatabase db): 创建 数据 库 时 执行 ,可 以 在 其 中 执行 创建 表 、 字 
段 、 视 图 和 触发 器 等 。 
* onUpgrade(SQLiteDatabse db ,int oldVersion,int newVersion); 当 数据 库 需 要 
更 新 时 执行 ,需要 实现 更 新 版 本 时 表 的 修改 ,删除 ` 创 建新 等 操作 。 

onUpgrade() 方 法 在 数据 库 的 版 本 发 生变 化 时 会 被 调用 ,数据 库 的 版 本 是 由 程序 员 
控制 的 ,假设 数据 库 现在 的 版 本 是 Version1. 0, 由 于 业务 的 需要 ,修改 了 数据 库 表 的 结 
构 , 这 时 候 就 需要 升级 软件 ,升级 软件 时 希望 更 新 用 户 手 机 里 的 数据 库 表 结构 ,为 了 实现 
这 一 目的 ,可 以 把 原来 的 数据 库 版 本 设置 为 Version 2。 并 且 在 onUpgrade() 方 法 里 面 实 
现 表 结 构 的 更 新 。 当 软件 的 版 本 升级 次 数 比 较 多 ,这 时 在 onUpgrade() 方 法 里 面 可 以 根 
据 原版 号 和 目标 版 本 号 进行 判断 ,然后 做 出 相应 的 表 结 构 及 数据 更 新 。onUpgrade() 方 
法 在 每 次 成 功 打开 数据 库 后 首先 被 执行 ,默认 情况 下 此 方法 的 实现 为 空 。 

在 创建 SQLiteOpenHelper 类 的 子 类 时 , 需要 通过 “super ( context, name, 
cursorFactory,version); "调用 SQLiteOpenHelper 的 构造 方法 。 其 中 参数 context 是 需 
要 附加 到 数据 库 的 数据 ;name 是 数据 库 的 名 称 ;cursorFactory 是 Cursor 的 一 个 子 类 对 
象 ,用 于 查询 ,可 以 是 空 ;version 指数 据 库 的 版 本 。 代 码 7. 20 是 定义 对 SQLite 数据 库 操 
作 的 SQLiteOpenHelper 子 类 的 模式 。 

代码 7.20 ” SQLiteOpenHelper 的 子 类 定义 模式 


public class DatabaseHelper extends SQLiteOpenHelper { 
DatabaseHelper (Context context, String name, CursorFactory 
cursorFactory, int version) { 
super (context, name, cursorFactory, version); 
//TODO SQLiteOpenHelper 构造 方法 
|: 


@override 

public void onCreate (SQLiteDatabase db) ( 
/ Topo 创建 数据 库 ,对 数据 库 的 操作 

) 


@override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) { 
/ /TODO 更 新 数据 库 的 操作 
h 


@override 
public void onOpen (SOLiteDatabase db) ( 
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super .onOpen (db); 
/ /TODO 每 次 成 功 打 开 数 据 库 后 首先 被 执行 


) 


下 面 在 Android 系统 中 创建 一 个 简单 的 数据 库 应 用 ,用 来 说 明 如 何 创建 、 操 作 
SQLite 数据 库 。 存 储 学 生 的 简单 信息 。 其 中 包括 
两 个 表 : Students 和 Departments。 

两 个 表 的 字段 定义 和 相互 之 间 的 关系 见 图 7. 5。 
表 Stdudents 的 主键 为 StdId, 表 Departments 的 主 
键 为 DeptId。 

首先 按照 代码 7. 20 中 定义 的 模式 创建 一 个 图 7.5 例子 中 的 实体 关系 图 
SQLiteOpenHelper 子 类 DatabaseHelper, 并 定义 一 
些 字符 串 常 量 , 见 代码 7.21。 

代码 7.21 定义 字符 串 常量 











Students 


Sd | 






Departments 








import android.content.ContentValues; 

import android.content.Context; 

import android.database.Cursor; 

import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 


public class DatabaseHe1per extends SQLiteOpenHelper ( 


static final String dbName="demoDB"; 

static final String studentTable="Students"; 
static final String colID="StdId"; 

static final String colName="StdName"; 
static final String colAge="Age"; 

static final String colDept="DeptId"; 


static final String deptTable="Departments"; 
static final String colDeptID="DeptId"; 
static final String colDeptName="DeptName"; 


static final String viewStds="ViewStds"; 


在 Android 系统 中 创建 数据 库 中 的 表 等 对 象 的 代码 在 onCreate() 方 法 中 执行 。 代 
码 7.22 中 是 SQLiteOpenHelper 的 onCreate() 方 法 ,这 里 创建 了 两 个 表 及 其 字段 、 一 个 
视图 和 一 个 触发 器 。 当 数据 库 创建 时 ,将 执行 这 些 代 码 。 也 就 是 当 这 个 数据 库 在 磁盘 中 
不 存在 时 ,会 在 创建 它 的 时 候 执 行 一 次 。 这 个 onCreate() 方 法 的 代码 在 同一 个 设备 中 只 
执行 一 次 。 





— 





CS EF Mndrod 平 台 的 移动 互联 网 应 用 开发 (E21) 
> 


代码 7.22 在 onCreate() 方 法 中 创建 数据 库 中 的 对 象 


public void onCreate (SQLiteDatabase db) { 
//TODO Auto- generated method stub 


db .execSOL ("CREATE TABLE "+deptTable+" ("+colDeptID 
+" INTEGER PRIMARY KEY , "+colDeptName+" TEXT)"); 


db.execSQL ("CREATE TABLE "+studentTable+" ("+colID 
+" INTEGER PRIMARY KEY AUTOINCREMENT, "+colName+" TEXT, " 
+colAge+" Integer, "+colDept 
+" INTEGER NOT NULL , FOREIGN KEY ("+colDept 
+") REFERENCES "+deptTable+" ("+colDeptID+"));"); 


db .execSQL ("CREATE TRIGGER fk_stddept_deptid "+" BEFORE INSERT " 
+" ON "+studentTable+ 
" FOR EACH ROW BEGIN"+" SELECT CASE WHEN ( (SELECT " 
+colDeptID+" FROM "+deptTable+" WHERE "+colDeptID 
+"=new."+colDept+") IS NULL)" 
+" THEN RAISE (ABORT, 'Foreign Key Violation') END; "+" END;"); 


db.execSQL ("CREATE VIEW "+viewStds+" AS SELECT "+studentTable 
+"."+colID+" AS id,"+" "+studentTable+"." 
+colName+","+" "+studentTable+"."+colAge+"," 
+" "+deptTable+"."+colDeptName+""+" FROM " 
+studentTable+" JOIN "+deptTable+" ON "+studentTable 
+"."+colDept+"="+deptTable+"."+colDeptID); 

//Inserts pre-defined departments 

InsertDepts (db); 

} 


Android SDK 包括 了 SQLite 数据 库 工 具 , 可 以 用 这 些 工 具 来 浏览 表 的 内 容 ,运行 
SQL 命令 ,以 及 执行 其 他 的 SQLite 数据 上 的 功能 。 
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数据 库 完整 性 (Database Integrity) 是 指数 据 库 中 数据 的 正确 性 和 相 容 性 。 数 据 库 完 
整 性 由 各 种 各 样 的 完整 性 约束 来 保证 的 。 其 中 ,数据 库 的 外 键 约束 保障 了 数据 库 的 域 完 
整 性 和 参照 完整 性 。 也 就 是 说 外 键 约束 实现 了 表 与 表 之 间 的 联系 ,外 键 的 取 值 必须 是 另 
一 个 表 的 主键 ,使 得 在 更 新 、 插 入 或 删除 操作 时 ,各 表 间 数据 保持 完整 性 。 

默认 情况 下 ,SQLite 3 数据 库 不 支持 外 键 约束 。 要 实现 SQLite 3 中 各 表 的 外 键 约束 
功能 ,需要 通过 定义 触发 器 Tigger 中 的 条 件 来 强制 实现 。 

下 面 使 用 图 7. 5 Students 表 和 Deparments 表 之 间 外 键 约束 的 实现 作为 例子 ,说 
明 如 何 根据 数据 库 设计 ,在 SQLite 3 中 定义 外 键 约束 。 创 建 触发 器 的 SQL 语句 如 下 : 
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CREATE TRIGGER fk stddept deptid Before INSERT ON Students 
FOR EACH ROW BEGIN 
SELECT CASE WHEN ( (SELECT DeptID FROM Dept WHERE DeptID= 
new.Dept) IS NULL) 
THEN RAISE (ABORT, 'Foreign Key Violation') END; 
END 


在 Android 代码 中 ,使 用 触发 器 实现 外 键 约束 功能 包括 两 个 步骤 : 

(1) 在 SQLiteOpenHelper 子 类 的 onCreate() 方 法 中 创建 触发 器 。 

(2) 覆盖 SQLiteOpenHelper 的 onOpen() 方 法 ,激活 触发 器 。 

首先 ,在 onCreate () 方 法 中 创建 数据 库 表 之 后 ,定义 创建 触发 器 的 语句 ,实现 外 键 约 
东 功 能 。 在 代码 7.22 中 使 用 execSQL() 方 法 实现 了 上 面 的 创建 触发 器 功能 。 代 码 如 下 : 


db .execSQL ("CREATE TRIGGER fk_stddept_deptid "+" BEFORE INSERT " 
+" ON "+studentTable+ 
" FOR EACH ROW BEGIN"+" SELECT CASE WHEN ( (SELECT " 
+colDeptID+" FROM "+deptTable+" WHERE "+colDeptID 
+"=new."+colDept+") IS NULL)" 
+" THEN RAISE (ABORT, 'Foreign Key Violation') END;"+" END;"); 


然后 ,覆盖 onOpen() 方 法 ,激活 数据 库 中 的 外 键 ( 见 代 码 7. 23) ,强制 实现 外 键 约束 。 
代码 7.23 激活 外 键 ,强制 实现 外 键 约束 


@override 
public void onOpen (SQLiteDatabase db) ( 
super.onOpen (db) ; 
if(!db.isReadOnly()) ( 
//Enable foreign key constraints 
db .execSQL ("PRAGMA foreign keys=ON;"); 
} 
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创建 SQLiteDatabase 的 表 、 视 图 和 触发 器 等 对 象 后 ,就 可 以 对 数据 库 进 行 数据 的 添 
加 、 查 询 、 更 新 和 删除 操作 。 使 用 SQLiteDatabase 对 象 执 行 SQL 语句 的 方法 db. 
execSQL (String statement), 可 以 执行 INSERT, DELETE, UPDATE 和 CREATE 
TABLE 之 类 有 更 改行 为 的 SQL 语句 ;使 用 db. rawQuery() 和 db. Query() 方 法 ,可 以 执 
行 SELEDCT 查询 语句 。 除 了 直接 执行 SQL 语句 的 方法 之 外 ,SQLiteDatabase 还 专门 提 
供 了 对 应 于 添加 、 删 除 、 更 新 、 查 询 的 操作 方法 : insert() .delete() .update() 和 query() 。 

要 查询 和 更 新 SQLite 数据 库 , 首 先 要 打开 数据 库 , 建 立 数 据 库 连接 。Android 系统 
调用 SQLiteOpenHelper 的 getWritableDatabase() 或 者 getReadableDatabase() 方 法 打开 


基于 Android 平台 的 移动 互联 网 应 用 开发 (第 版 ) 





数据 库 ,获取 用 于 操作 数据 库 的 SQLiteDatabase 实例 。 如 果 数 据 库 不 存在 , Android £ 
统 会 自动 生成 一 个 数据 库 , 然 后 调用 onCreate() 方 法 创建 数据 库 表 结构 及 其 他 数据 库 对 
象 ,并 添加 应 用 会 使 用 到 的 初始 化 数据 ,onCreate() 方 法 在 初次 生成 数据 库 时 才 会 被 调 
用 ,在 onCreate() 方 法 里 可 以 生成 数据 库 表 结 构 及 添加 一 些 应 用 使 用 到 的 初始 化 数据 。 

getWritableDatabase() 和 getReadableDatabase( ) 方 法 都 可 以 获取 一 个 用 于 操作 数 
据 库 的 SQLiteDatabase 实例 。getWritableDatabase() 方 法 以 读 写 方式 打开 数据 库 , 当 数 
据 库 的 磁盘 空间 满 时 ,数据 库 就 只 能 读 而 不 能 写 ,会 发 生 错误 ,需要 进行 异常 处 理 。 而 
getReadableDatabase() 方 法 返回 的 对 象 与 get WritableDatabase( ) 类 似 , 但 当 数 据 库 的 磁盘 
空间 满 时 ,以 只 读 方式 打开 数据 库 , 问 题解 决 后 ,就 可 能 够 以 调用 getWritableDatabase() 方 法 
重新 返回 一 个 可 读 写 的 SQLiteDatabase 数据 库 对 象 了 。 不 过 getReadableDatabase() 返 
回 需要 花费 很 长 时 间 ,最 好 不 要 在 主线 程 中 调用 。 

— H. SQLiteDatabase 实例 被 缓存 ,多 次 调用 getWritableDatabase ( ) 或 
getReadableDatabase() 方 法 得 到 的 都 是 同一 实例 。 如 果 不 再 使 用 数据 库 , 及 时 使 用 close() 
方法 关闭 数据 库 , 回 收 资源 。 

接 下 来 ,在 前 面 创建 的 数据 库 基础 上 ,使 用 简单 的 例子 说 明 在 Android 系统 中 ,通过 
SQLiteDatabase 如 何 对 数据 库 进行 操作 。 

1. 插入 记录 。 

要 使 用 SQLiteDatabase 对 象 进行 插入 操作 ,首先 要 使 用 getWritableDatabase() 以 
可 读 写 的 方式 打开 与 数据 库 的 连接 ,然后 使 用 ContentValues 类 的 对 象 创建 一 个 记录 , 通 
过 Content Values 类 的 put() 方 法 给 记录 逐个 字段 赋值 ,最 后 通过 SQLiteDatabase 的 
insert() 方 法 将 新 记录 插入 数据 库 中 ,关闭 数据 库 ( 见 代码 7. 24) 。 

其 中 Content Values. put(ColumnName,value) 参 数 的 有 两 个 ,ColumnName 是 表 的 
字段 名 称 ,value 是 新 记录 的 值 。 

代码 7.24 定义 插入 记录 操作 AddStudent() 


void AddStudent (Student std) { 
SQLiteDatabase db=this.getWritableDatabase(); 
ContentValues cv=new ContentValues (); 


cv.put (colName, std.getName ()); 
cv.put (co1Age, std.getAge () ) ; 
cv.put (colDept, std.getDept ()); 
//cv.put (colDept,2); 


db.insert (studentTable, colName, cv); 
db.close(); 
} 


对 于 insert() 方 法 本 身 来 说 ,无 论 第 三 个 参数 是 否 包 含 数据 ,执行 insert() 方 法 一 定 
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会 添加 一 条 新 记录 。 但 前 面 设置 了 外 键 约束 ,这 里 的 插入 要 遵从 外 键 约束 的 定义 。 同 样 
后 面 的 更 新 、 删 除 操作 都 要 遵从 外 键 约束 的 定义 。 

2. 更 新 记录 

Android 为 执行 更 新 语句 提供 两 种 方法 : db. execSQL() 和 db. update()。 

与 插入 记录 类 似 ,要 使 用 getWritableDatabase() 以 可 读 写 的 方式 打开 与 数据 库 的 连 
接 ,使 用 ContentValues 对 象 创建 新 记录 和 赋值 ,在 更 新 数据 库 记 录 时 ,可 以 使 用 
execSQL() 方 法 ,直接 把 SQL 语句 按 格式 写 人 参数 中 ,也 可 以 使 用 update() 方 法 更 新 。 
代码 7. 25 中 说 明了 使 用 update() 方 法 如 何 更 新 记录 。 

update() 方 法 的 参数 包括 四 个 : 
String Table: 所 需 更 新 记录 的 表 名 ; 
ContentValues cv: 赋予 新 值 后 的 纪录 ; 
String whereClause: 可 选 WHERE 子 句 ,格式 为 columnName +" =?" sk null, 
null 值 则 更 新 所 有 行 ， 
String[] whereArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 "?" 替 换 为 具 
体 的 值 ,没有 WHERE 子 句 则 为 null。 
代码 7.25 定义 更 新 记录 操作 UpdateStd() 


public int UpdateStd(Student std) { 
SQLiteDatabase db=this.getWritableDatabase(); 


ContentValues cv=new ContentValues (); 
cv.put (colName, std.getName () ) ; 
cv.put (colAge, std.getAge ()); 

cv.put (colDept, std.getDept ()); 


return db.update (studentTable, cv, colID+"=?", 
new String[] ( String.valueOf (std.getID()) )); 
ji 


3. 删除 记录 

Android 为 执行 删除 记录 提供 两 种 方法 : db. execSQL()#l db. delete() 。 

与 插入 和 更 新 SQLite 数据 库 类 似 , 使 用 getWritableDatabase() 以 可 读 写 的 方式 打 
开 与 数据 库 的 连接 后 ,删除 记录 可 以 使 用 execSQL() 方 法 ,也 可 以 使 用 delete() 方 法 。 代 
码 7. 26 说 明了 如 何 使 用 delete() 方 法 删除 数据 库 中 符合 要 求 的 记录 。 

delete() 的 参数 定义 与 insert() 类 似 。 

代码 7.26 定义 删除 记录 操作 DeleteStd() 


public void DeleteStd(Student emp) { 
SQLiteDatabase db=this.getWritableDatabase(); 


db.delete (studentTable, colID+"=?", 
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new String[] ( String.valueOf (emp.getID()) )); 
db.close(); 
} 


4. 执行 查询 

Android 为 执行 查询 记录 提供 两 种 方法 : db. rawQuery() 和 db. query()。 

查询 记录 时 ,使 用 getReadableDatabase() 以 可 读 方式 打开 与 数据 库 的 连接 ,然后 把 
查询 条 件 以 参数 形式 带 入 rawQuery() 或 query() 方 法 中 执行 ,返回 查询 结果 集 。 无 论 是 
rawQuery() 还 是 query() 方 法 ,每 个 SQLite 查 询 都 会 返回 一 个 Cursor 对 象 , 它 指向 查询 
结果 的 所 有 行 , 即 结果 集 。Cursor 对 象 始 终 能 够 在 数据 库 的 查询 结果 中 导航 ,并 且 能 够 
读 取 当 前 行 和 列 的 数据 。 

代码 7. 27 中 实现 了 查询 表 Departments 中 所 有 记录 的 功能 ,可 以 看 出 如 何 使 用 
rawQuery() 对 表 进 行 查询 。 

代码 7.27 rawQuery() 查 询 


Cursor getAllDepts () 
{ 
SQLiteDatabase db=this.getReadableDatabase (); 
Cursor cur=db.rawQuery ("SELECT "+colDeptID+" as id, 
"+colDeptName+" from "+deptTable,new String [] ()); 


return cur; 


} 


rawQuery() 的 参数 包括 两 个 : 
。 String query: 字符 串 形式 的 选择 语句 ,其 中 WHERE 子 句 中 的 条 件 值 使 用 “?” 
RE. 
。 String[] whereArgs: WHERE 子 句 中 “?” 对 应 的 具体 值 ,没有 WHERE 子 句 则 
为 null。 
代码 7. 27 中 查询 没有 WHERE 子 名 约束。 下 面 的 语句 是 加 上 WHERE FHAR, 
使 用 rawQnuery() 实 现 的 查询 ,查询 结果 是 从 表 Students 中 查询 DeptId 值 为 2 并 且 年 龄 
大 于 19 的 学 生 学 号 和 名 称 。 这 个 例句 可 以 更 进一步 清楚 说 明 rawQuery() 方 法 中 两 个 参 
数 的 使 用 。 


Cursor cur= db . rawQuery ("SELECT StdId as _id, StdName FROM Students WHERE 
DeptId=? AND Age>=?", new String[] ("2", "19")); 


这 个 查询 也 以 Cursor 对 象 作 为 返回 对 象 。 

在 rawQnuery() 第 一 参数 的 SELECT 语句 中 , 如果 数据 表 的 主键 字段 的 名 称 不 是 
“_id” ,那么 需要 使 用 "SELECT 字段 名 as _id” 子 句 把 主键 字段 的 别名 命名 成 “_id”, 因为 
Cursor 对 象 总 是 把 名 为 “~_id” 的 字段 作为 主键 ,否则 会 抛 出 异常 。 
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另 一 种 执行 查询 的 方法 是 使 用 db. query() 方 法 ,代码 7. 28 使 用 db. query() 实 现 查 
询 某 个 系 的 所 有 学 生 的 学 号 、 姓 名 、 年 龄 和 系 名 称 。 
代码 7.28 db. query() 查 询 


public Cursor getStdByDept (String Dept) { 


} 


SQLiteDatabase db=this.getReadableDatabase (); 
String[] columns=new String[] {" id", colName, colAge, colDeptName }; 
Cursor c=db.query (viewStds, columns, colDeptName+"=?", 

new String[] { Dept }, null, null, null); 


return c; 


db. query() 方 法 中 的 参数 , 按 顺 序 分 别 为 : 


7.4.5 


String TableName: 表 名 ; 

String [ ] columns; 查询 结果 的 字段 ; 
String [ ] whereArgs: WHERE 子 句 参数 ; 
String GroupBy: 分 组 子 句 ; 

String Having: HAVING 子 句 ; 

String OrderBy: 排序 子 句 ; 


管理 游标 Cursor 


游标 Cursor 是 数据 库 系 统 为 用 户 开设 的 一 个 数据 缓冲 区 ,存放 SQL 语句 查询 的 执 


行 结果 


。 每 个 游标 区 都 有 一 个 名 字 ,游标 能 从 包括 多 条 数据 记录 的 结果 集中 每 次 提取 一 


条 记录 进行 处 理 。 用 户 不 仅 可 以 用 SQL 语句 逐一 从 游标 中 获取 记录 ,并 赋 给 主 变量 , 交 
由 主语 言 进一步 处 理 。 游 标 还 允许 应 用 程序 对 查询 结果 集中 每 一 行进 行 相同 或 不 同 的 操 
作 , 而 不 是 一 次 对 整个 结果 集 进行 同一 种 操作 。 游 标 提供 对 基于 游标 位 置 而 对 表 中 数据 
进行 删除 或 更 新 的 功能 。 


在 
所 有 行 


Android 系统 中 ,每 个 SQLite 查询 都 会 返回 一 个 Cursor 对 象 , 它 指向 查询 结果 的 


， 即 结果 集 。Cursor 类 提供 许多 方法 ,可 以 根据 需要 访问 结果 集中 的 记录 。 


Cursor 游标 常用 方法 : 


getCount() : 获得 总 的 数据 项 数 ; 

isFirst() : 判断 是 否 第 一 条 记录 ; 

isLast() : 判断 是 否 最 后 一 条 记录 ; 

moveToFirst() : 移动 到 第 一 条 记录 ; 

moveToLast(); 移动 到 最 后 一 条 记录 ; 

move(int offset): 移动 到 指定 记录 ; 

moveToNext(): 移动 到 下 一 条 记录 ; 

moveToPrevious() : 移动 到 上 一 条 记录 ; 
getColumnIndexOrThrow(String columnName) : 根据 列 名 称 获得 列 索 引 ; 
getInt(int columnIndex) : 获得 指定 列 索 引 的 int 类 型 值 ; 


`x 
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。 getString(int columnIndex) : 获得 指定 列 缩影 的 String 类 型 值 。 

对 于 代码 7. 28 的 查询 结果 ,可 以 通过 Cursor 对 象 的 访问 ,输出 到 控制 台 ( 见 代 
码 7.29)。 

代码 7.29 结果 及 输出 


public void printQuery(Cursor c) { 


if(cursor.moveToFirst() ( // 判 断 游标 是 否 为 空 
for (int i=0;i<cursor.getCount () ;i++){ // 遍 历 游标 
cursor.move (i); 
int stdId=cursor.getInt (0); 
String stdName=cursor .getString (1); 
Int stdAge=cursor.getInt (2); 
String deptName=cursor.getString (3); 


// 输 出 用 户 信息 
System.out .println(stdId+" : "+stdName+" : "+stdAge+" : "+ 
deptName+"Nn"); 


7.5 本 章 小 结 


本 章 主要 介绍 了 Android 系统 的 数据 存储 机 制 和 存 取 方法 。Android 的 应 用 程序 可 
以 选择 的 本 地 数据 存储 方式 包括 Shared Preferences, Internal Storage, External Storage 
和 SQLite 数据 库 。 

Shared Preferences 保存 用 户 配置 偏好 的 存储 方式 ,使 用 键 值 对 的 形式 保存 私有 的 原 
始 数据 ,以 XML 格式 将 数据 存储 到 设备 中 。 

Android 的 应 用 程序 都 会 使 用 两 种 文件 夹 ,一 种 是 在 内 部 存储 (Internal Storage) E, 
用 来 保存 私有 数据 ;还 有 一 种 是 在 外 部 存储 (External Storage) 上 ,用 来 保存 公共 数据 。 
默认 情况 下 ,内 部 存储 文件 是 相应 程序 私有 的 ,对 其 他 程序 不 透明 ,对 用 户 也 是 不 透明 的 ， 
当 程 序 印 载 后 ,这 些 文件 就 会 被 删除 。 外 部 存储 的 文件 可 能 会 被 外 界 应 用 读 取 ,不 可 控 
制 。Android 系统 可 以 定义 三 种 作为 资源 的 文件 ,分 别 保存 在 三 个 不 同 资源 目录 中 ,分 别 
为 : /res/xml, /res/raw 和 /assets。 

Android 中 通过 SQLite 数据 库 引擎 来 实现 结构 化 数据 存储 。Android 系统 通过 
SQLiteDatabase 类 来 对 SQLite 数据 库 进行 访问 ,该 类 封装 了 一 些 操作 数据 库 的 API, 使 
用 该 类 可 以 完成 对 SQLite 中 数据 进行 添加 (Create) 、 查 询 (Retrieve) .更 新 (Update) 和 删 
除 (Delete) 操 作 。 


内 容 提 供 者 


任何 应 用 程序 都 可 以 通过 文件 系统 或 数据 库存 储 文件 ,其 他 应 用 程序 可 以 来 读 取 这 
些 文件 (当然 可 能 需要 某 些 访问 权限 的 设置 )。 在 Android 上 ,应 用 程序 的 所 有 数据 对 其 
他 应 用 程序 都 是 私有 的 ,其 他 应 用 只 有 通过 设置 权限 才 可 以 获取 数据 。Android 系统 提 
供 了 几 种 本 地 数据 的 存储 方式 , 如 果 要 将 这 些 数据 共享 , Android 通过 定义 
ContentProvider, 能 够 把 私有 数据 公开 给 其 他 应 用 程序 。 

ContentProvider 是 一 种 为 了 开放 应 用 程序 的 数据 读 写 ,具有 访问 权限 的 可 选 组 件 ， 
可 以 通过 这 个 组 件 实现 私有 数据 的 读 写 访问 , 译 为 中 文 是 “内 容 提供 者 ”。 
ContentProvider 提供 了 请 求 和 修改 数据 的 标准 语法 和 读 取 返 回 数据 的 标准 机 制 。 
Android 为 标准 的 数据 类 型 提供 了 一 些 ContentProvider, 如 图 像 ,视频 和 音频 文件 ,以 及 
个 人 通讯 录 信息 。Android 提供 几 种 持久 化 应 用 程序 数据 的 选择 ,具体 选择 哪 种 方式 依 
赖 于 具体 的 需求 ,例如 数据 应 该 是 应 用 程序 私有 的 还 是 共享 的 ,或 者 数据 所 需要 的 存储 空 
间 等 。 


8.1 ContentProvider 基础 


ContentProvider 是 Android 系统 提供 给 用 户 的 一 个 接口 ,用 于 管理 如 何 访问 应 用 程 
序 私 有 数据 的 存储 库 。 这 里 的 数据 包括 结构 化 存储 数据 和 非 结 构 化 存储 数据 。 


8.1.1 什么 是 ContentProvider 


第 7 章 我 们 提 到 过 ,一般 情况 下 ,一 个 Android 应 用 程序 的 数据 是 私有 的 ,其 他 应 用 
程序 不 具有 访问 的 权限 。 但 很 多 时 候 Android 应 用 程序 的 服务 包括 数据 的 服务 , 某 些 数 
据 希 望 开 放 给 其 他 Android 应 用 程序 使 用 。Android 系统 解决 这 个 问题 的 方法 是 定义 一 
个 通用 的 、 格 式 统一 的 数据 访问 接口 ,使 其 他 应 用 程序 可 以 通过 调用 这 个 接口 提供 的 方 
法 ,访问 和 修改 数据 。 

Android 系统 所 定义 的 访问 数据 资源 的 接口 称 为 ContentProvider。ContentProvider 
主要 是 被 其 他 应 用 程序 引用 ,为 应 用 程序 提供 一 个 一 致 的 ,标准 的 数据 访问 接口 ,其 中 包 
含 了 处 理 进程 间 的 联系 和 数据 安全 访问 。 应 用 程序 向 外 部 开放 数据 访问 ,都 通过 
ContentProvider 来 实现 。 

ContentProvider 向 外 部 应 用 程序 呈现 的 数据 就 像 一 张 二 维 表 , 就 像 是 在 关系 数据 库 
里 一 样 。 每 行 显 示 一 些 数据 类 型 的 实例 ,每 列 显示 实例 数据 集合 的 字段 。 例 如 在 
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Android 平台 上 有 一 个 内 置 的 ContentProvider 用 户 字典 ,存储 了 用 户 想 保存 的 非 标准 词 
的 拼写 , 表 8. 1 显示 了 数据 在 ContentProvider 的 表 中 可 能 看 起 来 的 样子 。 


表 8.1 ContentProvider 的 表 中 数据 




















Word app id frequency locale _ID 
mapreduce userl 100 en_US 1 
precompiler user14 200 fr_FR 2 
Applet user2 225 fr CA š 
Const userl 225 fr_BR 4 
Int user5 100 en_Uk 5 

















ER 8.1 中 ,每 行 代表 了 一 个 不 能 在 标准 字典 中 找到 的 词 ,每 一 列 代 表 了 这 个 词 的 一 
个 属性 。 第 一 行 是 存储 在 ContentProvider 中 的 列 名 称 。 在 这 个 ContentProvider 中 ,_ID 
列 作为 “主键 ? 列 ,由 ContentProvider 自动 管理 维护 。 

主键 对 于 一 个 ContentProvider 并 不 是 必须 具备 的 ,即使 有 主键 ,ContentProvider 也 
不 必 一 定 要 使 用 _ID 作为 主键 的 列 名 。 但 是 ,如 果 要 把 ContentProvider 中 的 数据 通过 用 
户 界 面 显 示 出 来 ,常常 需要 把 ContentProvider 绑 定 到 一 个 叫 作 ListView 的 用 户 界 面 控 
件 上 ,这 就 必须 有 一 个 列 名 叫做 _ID。 在 后 面 讨论 显示 查询 结果 的 部 分 ,会 对 此 有 详细 的 
解释 。 


84.2 访问 提供 器 ContentResolver 


应 用 程序 使 用 ContentResolver 客户 端 对 象 来 访问 ContentProvider 的 数据 ,可 以 称 
其 为 访问 提供 器 。ContentResolver 的 方法 提供 了 基本 的 CRUD( 创 建 , 检 索 , 更 新 和 删 
除 ) 数 据 存储 的 功能 。 

应 用 程序 通过 ContentResolver 的 对 象 访 问 ContentProvider 时 ,所 使 用 的 方法 会 调 
用 ContentProvider 一 个 具体 子 类 对 象 的 相同 名 字 的 方法 。 例 如 ,为 了 从 用 户 字 典 的 
ContentProvider 中 获得 单词 和 它们 出 现 的 语言 环境 列表 ,可 以 使 用 ContentResolver. 
query() 方 法 ( 见 代 码 8. 1)。 这 个 query() 方 法 会 调用 在 用 户 字 典 ContentProvider PE 
义 的 ContentProvider. query() 方 法 。 

代码 8.1 ContentResolver. query() 的 调用 


// 访 问 用 户 字典 并 返回 游标 
mCursor=getContentResolver() .query( 
UserDictionary.Words .CONTENT URI, // 词 表 的 内 容 URI 
mProjection, // 每 行 中 返回 数据 的 列 的 名 称 
//null 表示 返回 所 有 列 的 数据 
mSelectionClause // 过 滤 条 件 
mSelectionArgs, // 过 滤 条 件 的 参数 


mSortOrder); // 返 回 行 的 排序 方式 
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ContentProvider. query() 方 法 的 参数 与 SQL 语言 中 SELECT 语句 的 参数 类 似 ,说 
明 如 下 : 


Uriuri; Content URI, X} W Provider 中 的 表 名 ; 

String[ jprojection: 查询 结果 中 包含 的 字段 ; 

String selection: 可 选 WHERE 子 句 ,格式 为 columnName 十 “一 ?? 或 null,null 值 
则 更 新 所 有 行 ; 

String[ ] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 蔡 换 为 
具体 的 值 ,没有 WHERE 子 句 则 为 null; 

String sortOrder: 排序 子 句 。 

因此 ,在 使 用 其 他 应 用 程序 定义 的 Povider 数据 时 , 对 于 应 用 程序 来 说 ， 
ContentResolver 的 对 象 只 是 一 个 访问 器 ,用 于 与 Provider 连接 以 及 传递 操作 和 参数 ,并 
不 需要 知道 数据 的 具体 存储 结构 ,也 不 需要 编码 实现 功能 ,具体 的 访问 操作 由 Provider 
子 类 的 同名 方法 来 完成 。 这 样 ,其 他 应 用 程序 只 要 了 解 Provider 的 数据 二 维 表 ,就 可 以 
完成 数据 交互 了 。 

当然 ,如 果 要 访问 Provider, 应 用 程序 必须 在 Manifest 文件 中 添加 特定 的 权限 。 这 
部 分 内 容 将 在 ContentProvider 权限 中 详细 介绍 。 

客户 端 应 用 程序 进程 中 的 ContentResolver 对 象 和 ContentProvider 对 象 会 自动 处 
理 进 程 间 通信 。ContentProvider 也 会 以 二 维 表 的 形式 ,在 存储 的 数据 和 数据 的 外 部 显示 
之 间作 为 中 间 的 抽象 层 。 

8.1.3 内 容 统一 资源 标识 

在 调用 ContentProvider. query() 方 法 时 ,第 一 个 参数 是 URI 类 的 对 象 。URI 是 
Android 用 来 描述 Content URI 的 类 。 

什么 是 Content URI W? 通用 资源 标志 符 Universal Resource Identifier, 简称 URI, 
Content URI 就 是 ContentProvider 中 数据 的 内 容 统一 资源 标识 ,能 够 在 存储 介质 中 唯一 
标识 ContentProvider 中 数据 所 在 的 具体 位 置 。 这 有 点 类 似 通 过 Web 地 址 去 访问 网 页 。 
ContentProvider 对 象 通过 URI 来 选择 要 访问 Provider 的 表 和 数据 , 当 调 用 
ContentResolver 客户 端的 方法 来 访问 Provider 中 的 一 个 表 时 ,会 把 这 个 表 对 应 的 URI 
标识 作为 参数 传递 给 调用 的 方法 。 

在 Android 系统 中 ,Content URI 主要 分 三 个 部 分 : scheme authority 和 path, HP 
authority 又 分 为 host 和 port( 见 图 8.1) 。 
content://com.example.transportationprovider/trains/122 

A B c D 
图 8.1 通用 资源 标识 符 URI 结构 





一 般 来 说 ,资源 标识 符 的 结构 包括 三 个 部 分 : 协议 类 型 .资源 名 称 和 路 径 。 下 面 对 照 
Internet 的 统一 资源 定位 符 , 分 别 说 明 在 Content URI 中 这 三 部 分 的 具体 定义 。 
协议 类 型 : 称 为 scheme, 对 应 图 8. 1 中 的 A 部 分 ,表示 资源 的 类 型 。 如 果 是 网 站 资 
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源 则 为 “HTTP://”,Content URI 则 为 “content://”。 

资源 名 称 : 称 为 authority, 对 应 图 8. 1 中 的 B 部 分 ,表示 资源 的 唯一 名 称 。 如 果 是 网 
站 资源 则 为 域名 ,Content URI 中 则 是 Provider 的 唯一 标识 名 称 , 可 以 使 用 包 和 类 名 来 定 
义 Provider 资源 名 称 。 

路 径 : 称 为 path, 对 应 图 8.1 中 的 C 和 了 D 部 分 ,表示 资源 中 的 数据 。 如 果 是 网 站 资 
源 则 为 服务 器 上 网 页 的 路 径 名 , Content URI 中 则 是 Provider 中 的 表 名 或 指定 表 中 的 记 
录 。 例 如 图 8. 1 中 C 和 D 都 是 用 来 指定 路 径 ,C 一 般 用 来 指定 数据 库 中 表 的 名 字 , 这 里 
指出 使 用 trains 表 中 的 数据 ,D 可 以 用 来 指定 数据 库 中 的 一 条 记录 ,这 里 指定 了 ID 为 
122 的 记录 ,如 果 没 有 指定 ID, 就 表示 返回 全 部 记录 。 


8.1.4 MIME 类 型 


MIME 的 英文 全 称 是 Multipurpose Internet Mail Extensions, 称 为 多 用 途 互联 网 邮 
件 扩展 。 这 是 一 种 互联 网 标准 。 在 1992 年 ,MIME 最 早 应 用 于 电子 邮件 系统 ,后 来 也 应 
用 到 浏览 器 。 当 用 户 访 问 网 站 资源 时 ,服务 器 会 返回 资源 的 MIME 类 型 ,浏览 器 会 根据 
MIME 的 类 型 调用 正确 的 程序 来 查看 内 容 。 

ContentProvider 也 为 给 定 资源 定义 了 MIME 类 型 。 每 个 MIME 类 型 由 两 部 分 组 
成 ,前 面 是 数据 的 大 类 别 ( 例 如 audio 代表 声音 数据 ,image 代表 图 像 数 据 text 代表 文本 
数据 等 ) ,后面 定义 具体 的 子 类 别 ,格式 为 : 大 类 别 / 子 类 别 。 例 如 下 面 是 一 些 常 用 的 
MIME 类 型 。 
text/html; 


text/css; 


text/xml; 


text/vnd. curl; 


application/pdf; 


application/rtf; 


application/vnd. ms-excel。 

Internet 中 有 一 个 专门 组 织 IANA 来 确认 标准 的 MIME 类 型 ,在 IANA 互联 网 数字 
分 配 机 构 网 站 上 可 以 看 到 已 注册 的 类 型 和 子 类 型 的 完整 列表 ,网址 为 http://www. iana. 
org/assignments/media-types/ o 

已 注册 的 主要 类 型 包括 application, audio, example, message, model, multipart, text, 
video。 如 果 供 应 商 具 有 专用 的 数据 格式 ,那么 子 类 型 名 称 将 以 vnd 开头 ,例如 微软 Excel 
电子 表格 使 用 子 类 型 vnd. ms-excel 标识 ,而 pdf 被 视 为 一 种 专用 供应 商标 准 ,所 以 对 它 
的 标识 没有 任何 供应 商 特定 的 前 级 。Internet 发 展 得 太 快 ,很 多 应 用 程序 等 不 及 IANA 
来 确认 它们 使 用 的 MIME 类 型 为 标准 类 型 。 因 此 它们 使 用 在 类 别 中 以 x- 开 头 的 方法 标 
识 这 个 类 别 还 没有 成 为 标准 ,例如 x-gzip,x-tar 等 。 事实 上 这 些 类 型 运用 得 很 广泛 ,已 经 
成 为 了 事实 标准 。 只 要 客户 机 和 服务 器 共同 承认 这 个 MIME 类 型 ,即使 它 是 不 标准 的 类 
型 也 没有 关系 ,客户 程序 就 能 根据 MIME 类 型 ,采用 具体 的 处 理 手段 来 处 理 数据 。 而 
Web 服务 器 和 浏览 器 (包括 操作 系统 ) 中 ,默认 都 设置 了 标准 的 和 常见 的 MIME 类 型 ,只 
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有 对 于 不 常见 的 MIME 类 型 , 才 需 要 同时 设置 服务 器 和 客户 浏览 器 ,以 进行 识别 。 
Android 遵循 类 似 的 约定 来 定义 MIME 类 型 ,而 且 每 个 内 容 类 型 的 MIME 类 型 都 具 
有 两 种 形式 : 单条 记录 和 多 条 记录 。 
对 于 单条 记录 ,MIME 类 型 类 似 于 : 


vnd.android.cursor.item/vnd.yourcompanyname.contenttype; 
对 于 多 条 记录 ,MIME 类 型 类 似 于 : 
vnd.android.cursor.dir/vnd.yourcompanyname.contenttype 


上 面 两 个 MIME 类 型 中 ,vnd. android. cursor. dir 表示 返回 多 行 结果 ; vnd. android. 
cursor. item 表示 返回 单行 结果 ,而 子 类 型 是 指 特定 的 Provider, Android 内 置 的 
Provider 通常 有 一 个 简单 的 子 类 型 。 例 如 : 通讯 录 的 应 用 中 , 当 创建 一 个 电话 号 码 时 ,可 
以 设置 MIME 类 型 为 vnd. android. cursor. item/phone_v2 ,其 中 子 类 型 为 phone_v2 , 

ContentProvider 开发 人 员 可 以 基于 Provider 资源 名 称 和 表 名 创建 它们 自己 的 子 类 
型 模式 。 例 如 考虑 一 个 包含 列车 时 刻 表 的 Provider, Provier 的 资源 名 称 为 com. example. 
trains, 其 包含 的 表 有 Linel, Line? 和 Line3。 如 果 访 问 表 Linel 的 Content URI 为: 


content://com.example.trains/Linel 
则 对 于 表 Linel,Provider 返回 MIME 类 型 为 多 条 记录 : 
vnd.android.cursor.dir/vnd.example.linel 
如 果 访 问 表 Line2 的 Content URI 为 : 
content://com.example.trains/Line2/5 
则 对 于 表 Line2 的 行 5,Provider 返回 的 MIME 类 型 为 单条 记录 : 
vnd.android.cursor.item/vnd.example.line2 


ContentProvider 类 提供 了 两 个 方法 返回 MIME 类 型 ,其 中 getType() 方 法 是 必须 实 
现 的 方法 ;如 果 使 用 ContentProvider 提供 文件 类 型 数据 ,需要 实现 getStreamTypes() 
方法 。 


8.2 使 用 ContentProvider 


下 面 介 绍 ContentProvider 的 使 用 方法 。 
8.2.1 获取 数据 
Android 应 用 程序 通过 Content URI 定位 ,来 获取 ContentProvider 中 所 需要 的 数 
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据 。Content URI 对 于 ContentProvider 来 说 是 唯一 的 ,对 于 开发 人 员 来 说 也 是 非常 重要 
的 。 因 此 ,通常 在 ContentProvider 中 将 Content URI 定义 为 常量 ,方便 开发 人 员 的 引用 。 
下 面 是 Android 系统 预定 义 的 一 些 ContentProvider 的 Content URI 常量 。 


MediaStore.Images.Media .INTERNAL CONTENT URI 
MediaStore.Images.Media .EXTERNAL CONTENT URI 
ContactsContract.Contacts.CONTENT URI 


这 些 常 量 对 应 的 Content URI 的 值 如 下 : 


content://media/internal/images 
content://media/external/images 
content://com.android.contacts/contacts/ 


Android 系统 的 内 置 通讯 录 Provider 使 用 ContactsContract. Contacts. CONTENT 
URI 常量 来 标识 Provider 中 联系 人 数据 。 

有 了 具体 的 Content URI, 为 了 从 Provider 中 检索 数据 ,需要 两 个 基本 步骤 : 

步骤 一 ,给 提供 器 申请 读 访问 权限 ; 

步骤 二 ,构造 查询 代码 。 

下 面 以 用 户 字 典 的 ContentProvider 为 例 ,说 明 如 何 从 其 中 获取 数据 。 

(1) 给 提供 器 申请 读 访问 权限 。 

能 够 从 ContentProvider 中 获取 数据 的 前 提 , 首 先是 所 访问 的 ContentProvider 允许 
其 他 应 用 程序 的 读 访问 。 

从 ContentProvider 中 获取 数据 ,应 用 程序 需要 “ 读 权 限 ”"。 这 个 权限 不 能 在 应 用 程序 
运行 时 设置 ,需要 在 应 用 程序 的 Manifest 文件 中 预先 声明 需要 的 权限 元 素 。 如 果 指 定 了 
这 个 元 素 , 当 用 户 安装 这 个 应 用 程序 时 ,系统 会 隐 式 地 赋予 其 相应 的 权限 。 

Manifest 文件 中 的 权限 声明 元 素 是 二 uses-permission 之 元素, 权限 的 值 从 将 要 访问 
ContentProvider 所 定义 的 权限 中 选择 ,根据 需求 指定 准确 的 权限 名 称 。 例 如 ,用 户 字典 
的 ContentProvider 定义 了 权限 android. permission. READ_USER_DICTIONARY , 作 
为 其 可 读 取 的 权限 。 如 果 应 用 程序 需要 从 用 户 字典 的 ContentProvider 读 取 数据 ,就 需要 
在 其 Manifest 文件 中 声明 用 户 字典 的 ContentProvider 的 可 读 取 。 代 码 如 下 : 


<uses-permission android:name=" android.permission.READ USER DICTIONARY" 
/> 


在 使 用 不 同 的 ContentProvider 时 ,如 果 要 了 解 所 使 用 的 ContentProvider 有 哪些 具 
体 的 访问 权限 和 权限 确切 的 名 字 , 可 以 参考 ContentProvider 的 文档 。 

(2) 构造 查询 代码 。 

权限 申请 完成 后 ,从 ContentProvider 中 检索 数据 的 第 二 步 就 是 构建 查询 程序 。 接 下 
来 ,以 用 户 字 典 的 ContentProvider 为 例 ,说 明 如 何 使 用 ContentResolver. query() 获 取 其 
中 的 数据 。 


/ 
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由 于 ContentResolver. query() 的 参数 对 应 于 SEIECT 语句 的 结构 ,类 似 于 关系 数据 
库 表 的 查询 。 因 此 如 果 要 获取 某 个 ContentProvider 中 的 数据 , 必须 要 清楚 这 个 
ContentProvider 可 以 提供 什么 数据 内 容 , 也 就 是 明了 这 个 二 维 表 的 结构 。 这 可 以 从 
ContentProvider 的 文档 中 查 到 。 

首先 在 应 用 程序 中 ,对 应 ContentResolver. query() 的 参数 ,声明 一 些 访问 用 户 字 典 
Provider 所 需要 的 一 些 变量 ( 见 代 码 8. 2)。 

代码 8.2 变量 声明 


public class TryAccessDictionary( 


String[] mProjection={ 
UserDictionary.Words. ID, //Contract class constant for the _ID 
column name 
UserDictionary.Words.WORD, //Contract class constant for the word 
column name 
UserDictionary.Words.LOCALE //Contract class constant for the 
locale column name 


J; 


//Defines a string to contain the selection clause 
String mSelectionClause=null; 


//Initializes an array to contain selection arguments 
String[] mSelectionArgs={""}; 
ii 


当 调 用 ContentResolver. query ( ) 方法 时 ,其 实际 调用 了 Provider 中 的 
ContentProvider. query() 方 法 。ContentResolver. query() 方 法 返回 的 结果 是 一 个 游标 对 
象 ,下 面 详细 说 明 其 参数 的 作用 。 

。 Uri uri; 对 应 Provider 中 的 表 名 对 应 的 Content URI, 

。 String[ jprojection: 查询 结果 中 包含 的 字段 。 这 是 一 个 数组 ,指定 需要 返回 数据 
的 列 , 如 果 为 null 则 返回 所 有 列 。 从 效率 上 来 说 ,如 果 不 是 用 到 所 有 的 列 ,最 好 明 
确 指 定 。 

String selection; 指定 过 滤 数 据 的 条 件 , 其 格式 相当 于 SQL 选择 语句 中 的 
WHERE 子 句 的 条 件 表达 式 , 如 果 为 null, 则 表示 返回 所 有 行 。 一 般 来 说 查询 数 
据 的 SQL 表达 式 是 有 WHERE 条 件 的 ,而 ContentResolver. query() 方 法 中 的 
selection 参数 就 对 应 WHERE 条 件 , 它 是 一 个 逻辑 布尔 值 、 列 名 数值 的 复合 表 
达 式 。 

String[ ] selectionArgs: 如 果 在 selection 参数 使 用 了 “?” 占 位 符号 ,表示 这 个 位 置 
需要 指定 一 个 条 件 值 。 而 这 个 数值 是 由 selectionArgs 参数 指定 的 。 如 果 
selection 参数 中 有 多 个 “?” 占 位 符 , selectionArgs 参数 中 字符 串 数组 的 顺序 与 
selection 参数 顺序 一 致 。 
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为 什么 需要 通过 这 种 方式 传人 条 件 参数 呢 ? 这 是 为 了 防止 恶意 输入 SQL 语句 。 如 
果 ContentProvider 管理 的 数据 保存 在 SQL 数据 库 里 ,假设 有 外 部 不 可 信 的 数据 插入 到 
原始 的 SQL 语句 中 ,有 可 能 导致 恶意 SQL 输入 。 

假设 条 件 参数 变量 定义 如 下 : 


String mSelectionClause="var="+mUserInput; 


如 果 mUserInput 是 一 个 需要 用 户 输入 的 变量 ,这 就 为 插入 恶意 的 SQL 语句 提供 了 
条 件 ,例如 用 户 可 以 在 界面 为 mUserInput 变量 输入 : 


nothing; DROP TABLE *;ç 


这 样 在 数据 库 上 执行 的 就 不 止 一 条 查询 语句 了 ,会 执行 DROP 操作 ,就 会 导致 
ContentProvider 删除 SQLite 数据 库 里 所 有 的 表 。 为 了 解决 这 个 问题 ,使 用 一 个 带 有 “?” 
作为 可 蔡 代 的 选择 参数 ,然后 再 使 用 另 一 个 选择 参数 数组 来 组 合 定义 查询 方法 。 这 样 , 用 
户 的 输入 会 直接 绑 定 到 查询 方法 的 选择 参数 中 , 而 不 是 作为 SQL 语句 的 一 部 分 被 解释 。 
由 于 它 没有 被 视 为 是 SQL 语句 ,用 户 输入 不 可 以 注入 恶意 的 SQL。 

。 String sortOrder: 排序 子 句 。 指 定数 据 行 的 排列 规则 ,其 格式 相当 于 SQL 语句 

的 ORDER BY 子 句 中 的 表达 式 。 如 果 为 null, 则 使 用 默认 的 排序 方式 ,或 者 不 
排序 。 

代码 8. 3 定义 好 变量 ,就 可 以 编写 获取 数据 的 方法 了 。 

代码 8.3 获取 ContentProvider 数据 


private Cursor getWordDictionary (String mSearchString) { 

String mSelectionClause; 

String[] mSelectionArgs=new String[1]; 

if (TextUtils.isEmpty (mSearchstring)) { 
mSelectionClause=null; 
mSelectionArgs=null; 

} else { 
mSelectionClause=UserDictionary.Words.WORD+"=?"; 
mSelectionArgs[0]=mSearchString; 

ji 

Cursor mCursor=getContentResolver().query( 

UserDictionary.Words.CONTENT URI, 
mProjection, 

mSelectionClause, 

mSelectionArgs, 

mSortOrder); 


return mCursor; 
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(3) 显示 查询 结果 。 

ContentResolver. query() 方 法 执行 后 ,返回 的 是 游标 对 象 ,这 是 一 个 查询 结果 集合 。 
如 果 遍 历 这 个 游标 对 象 ,就 可 以 读 取 结 果 集 中 的 所 有 数据 ,输出 查询 结果 。 代 码 8. 4 中 使 
用 Cursor 的 move() 方 法 在 结果 集中 移动 游标 指针 ,使 用 Cursor 的 getString() 方 法 获取 
当前 记录 各 字段 的 值 , 并 在 控制 台 输 出 个 记录 结果 。 

代码 8.4 输出 查询 结果 


public void printQueryResult (Cursor c) { 


if(cursor.moveToFirst() { 
for (int i=0;i<cursor.getCount();i++)( 
Cursor .move (i); 
String word=cursor.getString(0); 
String user=cursor.getString (1); 
String local=cursor.getString (2); 


// 输 出 用 户 信息 


System.out .println (word+" : "+user+" : "+local+"\n"); 


} 


822 修改 数据 


如 果 需 要 插入 、 更 新 或 者 删除 数据 ,首先 要 考虑 的 还 是 权限 的 问题 。 

需要 为 ContentProvider 定义 不 同 的 数据 访问 权限 ,以 便 其 他 应 用 能 够 访问 其 提供 的 
数据 。 权 限 的 定义 可 以 保证 用 户 能 够 知道 应 用 程序 中 的 哪些 数据 可 以 访问 。 基 于 
ContentProvider 提供 的 说 明 ,其 他 的 应 用 程序 可 以 根据 自身 的 需求 来 申请 权限 去 访问 
ContentProvider。 最 后 ,用 户 在 安装 此 应 用 时 会 看 到 该 应 用 请 求 获 得 的 权限 。 

如 果 包 含 ContentProvider 的 应 用 没有 指定 任何 权限 ,其 他 的 应 用 程序 是 无 法 访问 该 
ContentProvider 的 数据 的 。 但 是 无 论 是 否 指定 了 权限 ,包含 ContentProvider 应 用 的 其 
他 组 件 拥有 对 该 ContentProvider 的 完全 读 写 权 限 。 

正如 上 面 所 说 ,在 用 户 字 典 中 使 用 ContentProvider android. permission. WRITE_ 
USER_DICTIONARY 权限 来 控制 对 数据 的 插入 、 更 新 和 删除 。 

为 获得 访问 ContentProvider 的 权限 ,应 用 程序 在 Manifest 文件 中 需要 使 用 uses- 
permission 标签 。 当 Android Package Manager 安装 应 用 时 ,用 户 必须 批准 应 用 程序 的 
所 有 权限 请 求 。 如 果 用 户 允 许 , Package Manager 会 继续 安装 流程 ; 如果 用 户 不 允许 ， 
Package Manager 会 终止 安装 。 

例如 ,在 应 用 程序 中 插入 、 更 新 或 者 删除 用 户 字 典 ContentProvider 的 数据 ,需要 在 
manifest 文件 中 声明 android. permission. WRITE_USER_DICTIONARY 权限 。 例 如 : 


<uses-permission android:name="android.permission.WRITE USER DICTIONARY" /> 


Nap 
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(1) 插入 数据 。 

如 果 向 ContentProvider 中 插入 数据 ,需要 调用 ContentResolver. insert() 方 法 。 这 
个 方法 向 ContentProvider 中 插入 一 行 新 数据 ,然后 返回 该 行 数据 的 资源 标识 符 。 

ContentResolver. insert() 方 法 的 参数 说 明 如 下 : 

。 Uri url: 资源 标识 符 Content URI; 

。 ContentValues values; Content Values 对 象 , 存 有 所 要 插入 的 新 记录 各 字段 的 值 。 

ContentValue 对 象 的 使 用 与 第 7 章 相 同 , 使 用 ContentValue. put() 分 别 给 每 个 字段 
赋值 ,前 一 个 参数 是 Provider 表 定义 的 字段 名 称 ,后 一 个 参数 是 给 这 个 字段 的 赋值 。 

代码 8.5 中 实现 了 给 用 户 字典 Provide 添加 一 行 新 记录 的 功能 。 首 先 创建 一 个 新 的 
ContentValue 对 象 ,通过 put() 把 值 分 别 赋 给 各 个 字段 。 这 条 数据 中 并 没有 插入 _ID F 
段 , 那 是 因为 它 会 自动 地 被 增加 到 数据 中 。Provider 会 给 每 一 行 数据 赋予 一 个 唯一 的 
_ID, 而 它 往往 就 被 看 作 数 据 库 表 中 的 主键 。 

代码 8.5 插入 数据 


Uri mNewUri; 
//Defines an object to contain the new values to insert 
ContentValues mNewValues=new ContentValues (); 
14 
* Sets the values of each column and inserts the word. The 
* arguments to the "put" method are "column name" and "value" 
8.7 
mNewValues.put (UserDictionary.Words.APP_ID, "example.user"); 
mNewValues.put (UserDictionary.Words.LOCALE, "en_US"); 
mNewValues.put (UserDictionary.Words.WORD, "insert"); 
mNewValues.put (UserDictionary.Words.FREQUENCY, "100"); 


mNewUri=getContentResolver().insert( 
UserDictionary.Words.CONTENT URI, 
mNewValues //the values to insert 
); 
mCursor=getWordDictionary (null); 
mCursorAdapter.changeCursor (mCursor); 
Toast .makeText (this, "插入 数据 为 "+mNewUri.getEncodedPath()， 
Toast .LENGTH SHORT) . show () ; 


ContentResolver. insert() 方 法 的 返回 值 为 新 增加 行 的 资源 标识 符 ,格式 如 下 : 
content://user_dictionary/words/<id value> 


其 中 的 id_value 为 新 增 行 的 _ID。Android 系统 还 提供 了 自动 检测 资源 标识 符 格式 
的 API, 例 如 调用 ContentUris. parseId() 方 法 ,返回 资源 标识 符 的 _ID 值 。 
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(2) 更 新 数据 。 

如 果 要 更 新 Provider 中 的 数据 ,需要 使 用 ContentResolver. update() 方 法 。 与 插入 
数据 类 似 ,使 用 ContentValues 对 象 来 存储 更 新 数据 ,同时 与 查询 语句 相同 的 条 件 参数 。 
如 果 仅 仅 需要 更 新 某 些 字段 ,只 需要 把 这 些 字 段 的 值 添加 到 ContentValues 对 象 中 。 如 
果 需 要 清除 一 列 的 值 , 则 把 这 列 设 为 null。 

ContentResolver. update() 方 法 的 参数 说 明 如 下 : 

e Uri uri; Content URI, 

。 ContentValues values: 带 有 记录 更 新 值 的 ContentValues 对 象 。 

。 String where: WHERE 子 句 ,具体 的 条 件 值 使 用 “?” 替 代 。 

。 String[ ] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 替 换 为 
具体 的 值 ,没有 WHERE 子 句 则 为 null, 

ContentResolver. update() 方 法 用 来 定义 要 更 新 的 列 和 更 新 的 值 , 如 果 我 们 要 清除 某 
一 列 的 内 容 ,使 用 Content Values. putNull() 方 法 将 此 值 设 为 null。 

代码 8.6 的 例子 中 实现 了 对 用 户 字典 Provider 表 中 记录 的 条 件 更 新 , 选 出 "word” 字 
段 值 中 以 “en 开头 的 记录 ,把 其 "local” 字 段 更 新 为 null。 

代码 8.6 更 新 数据 


//Defines an object to contain the updated values 
ContentValues mUpdateValues=new ContentValues (); 


//Defines selection criteria for the rows you want to update 
String mSelectionClause=UserDictionary.Words.LOCALE+"LIKE ?"; 
String[] mSelectionArgs=("en_%"); 


//Defines a variable to contain the number of updated rows 
int mRowsUpdated=0; 
/* 
* Sets the updated value and updates the selected words. 
*/ 
mUpdateValues.putNull (UserDictionary.Words.LOCALE); 


mRowsUpdated=getContentResolver() .update ( 
UserDictionary.Words.CONTENT URI, //the user dictionary content URI 


mUpdateValues //the columns to update 
mSelectionClause //the column to select on 
mSelectionArgs //the value to compare to 


Yz 


mCursor=getWordDictionary (null); 
mCursorAdapter.changeCursor (mCursor); 
System.out .println ("更 新 行 数 为 "+mRowsUpdated); 








`` 基于 Androd 平台 的 移动 互联 网 应 用 开发 (SE 21) 


(3) 删除 数据 。 

如 果 要 删除 Provider 中 的 数据 ,需要 使 用 ContentResolver. delete() 方 法 。 删 除 
Provider 中 的 数据 与 查询 获取 数据 很 类 似 , delete() 方 法 不 需要 构造 新 的 记录 ,只 需要 指 
定 想 删除 行 的 选择 条 件 参数 ,返回 值 是 删除 的 行 数 。 

ContentResolver. delete() 方 法 的 参数 说 明 如 下 : 

e Uri uri: Content URI, 

。 String where: WHERE 子 句 ,具体 的 条 件 值 使 用 "?? 蔡 代 。 

。 String[] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 蔡 换 为 
具体 的 值 ,没有 WHERE 子 句 则 为 null。 

下 面 的 代码 删除 word 列 中 以 in 开头 的 单词 。ContentResolver. delete() 方 法 返回 删 
除 的 行 数 。 

代码 8.7 的 例子 中 实现 了 对 用 户 字 典 Provider 表 中 记录 的 删除 ,删除 “word” 字 段 值 
中 以 “in? 开 头 的 记录 。 

代码 8.7 删除 数据 


mSelectionClause=UserDictionary.Words .WORD+" LIKE ?"; 

mSelectionArgs[0]="in%"; 

//Defines a variable to contain the number of rows deleted 

int mRowsDeleted; 

//Deletes the words that match the selection criteria 

mRowsDeleted=getContentResolver() .delete( 
UserDictionary.Words.CONTENT_ URI, //the user dictionary 资源 标识 符 
mSelectionClause, //the column to select on 
mSelectionArgs //the value to compare to 

); 

mCursor=getWordDictionary (null); 

mCursorAdapter.changeCursor (mCursor); 

System.out .println ("删除 行 数 为 "+mRowsUpdated); 


(4) 批 模式 。 

Android 系统 还 提供 了 另外 一 种 操作 数据 的 方法 , 称 为 批 模式 。 批 模式 可 以 一 次 在 
一 个 表 中 插 和 人 多 行 , 或 者 插 和 信行 到 多 个 表 中 ,或 者 定义 一 个 事务 完成 一 系列 跨 处 理 边界 的 
操作 。 

如 果 要 通过 批 模式 访问 Provider, 需 要 创建 包含 ContentProviderOperation 对 象 的 
操作 数组 ,然后 通过 ContentResolver. applyBatch() 方 法 ,将 操作 数组 派发 到 Provider 上 
执行 。ContentResolver. applyBatch () 方 法 。 操 作 数组 中 的 ContentProviderOperation 
对 象 可 以 对 应 不 同 的 表 。ContentResolver. applyBatch() 方 法 返回 值 为 一 个 数组 。 

ContentResolver. applyBatch() 方 法 的 参数 说 明 如 下 : 

。 String authority: 字符 串 形式 的 Content URI 中 表 的 标识 ,指向 需要 操作 的 表 。 
e ArrayList<ContentProviderOperation> operations: 具体 的 操作 。 


第 8 章 ”内容 提供 者 


代码 8. 8 中 的 例子 ,通过 使 用 批 处 理 模式 对 ContactsContract 插入 操作 ,说 明了 如 何 
使 用 ContentResolver. applyBatch() 方 法 。 

ContactsContract 是 Android 为 通讯 录 提 供 的 Provider。 从 Android 2. 0( API Level 
5) 开 始 ,Android 平台 提供 了 一 个 改进 的 Contacts API, 以 适应 一 个 联系 人 可 以 有 多 个 账 
户 的 需求 ,例如 手机 通讯 录 和 Gmail 通讯 录 ,两 个 通讯 录 中 的 两 条 记录 可 以 是 同一 个 人 。 
新 的 Contacts API 主要 是 由 ContactsContract 及 其 相关 的 类 来 管理 ,联系 人 数据 被 放 到 
三 张 表 中 : Data, RawContacts 和 Contacts, 

ContactsContract. Data 表 存 储 了 联系 人 的 详细 信息 , 表 中 的 每 一 行 存储 一 个 特定 类 
型 的 信息 ,比如 Email, Address 或 Phone, 

ContactsContract. RawContacts 用 于 关联 联系 人 信息 与 账号 ,因为 有 可 能 手机 的 联 
系 人 信息 是 从 不 同 的 Gmail 或 者 其 他 地 方 导入 的 ,为 互相 区 别 并 方便 同步 , 特 引 入 账号 
概念 。 

ContactsContract. Contacts 表 中 的 一 行 表 示 一 个 联系 人 , 它 是 RawContacts 表 中 的 
一 行 或 多 行 的 数据 的 组 合 , 这些 RawContacts 表 中 的 行 表 示 同 一 个 人 的 不 同 的 账户 信 
息 。Contacts 中 的 数据 由 系统 组 合 RawContacts 表 中 的 数据 自动 生成 。 

代码 8. 8 实现 了 从 用 户 界面 获取 信息 ,然后 把 相应 的 信息 插入 通讯 录 的 功能 。 因 为 
插入 涉及 Data、,RawContacts 和 Contacts 三 个 表 , 所 以 使 用 批 处 理 来 执行 。 具 体 的 UI 界 
面 设计 与 实现 参见 第 2 章 的 知识 ,这 里 省 略 。 

代码 8.8 使 用 批 模式 操作 通讯 录 


protected void createContactEntry() { 

//Get values from UI 

String name=mContactNameEditText .getText () .tostring(); 

String phone=mContactPhoneEditText .getText () .toString (); 

String email=mContactEmailEditText .getText () .toString () 7 

int phoneType=mContactPhoneTypes.get ( 
mContactPhoneTypeSpinner.getSelectedItemPosition()); 

int emailType=mContactEmailTypes.get( 
mContactEmailTypeSpinner.getSelectedItemPosition());; 


Arraylist<ContentProviderOperation>ops=new ArrayList 
<ContentProviderOperation> (); 


// 首 先 向 RawContacts .CONTENT URI 执行 一 个 插入 
// 目 的 是 获取 系统 返回 的 rawContactId 
ops.add (ContentProviderOperation.newInsert (RawContacts.CONTENT URI) 
.withValue (RawContacts .ACCOUNT TYPE, mSelectedAccount.getType () ) 
.withValue (RawContacts.ACCOUNT NAME, 
mSelectedAccount.getName ()) 
-build()) > 
// 往 data 表 写 人 姓名 数据 








—— 
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ops.add (ContentProviderOperation.newInsert (Data.CONTENT URI) 


.withValueBackReference (Data.RAW CONTACT ID, 0) 

.withValue (Data .MIMETYPE, 

CommonDataKinds .StructuredName .CONTENT ITEM TYPE) 

.withValue (CommonDataKinds.StructuredName.DISPLAY NAME, name) 
-build()); 


// 往 data 表 写 人 电话 数据 


ops ,add (ContentProviderOperation.newInsert (Data.CONTENT URI) 


.withValueBackReference (Data.RAW CONTRCT ID，0) 
.withValue (Data.MIMETYPE, 


CommonDataKinds .Phone .CONTENT_ITEM TYPE) 


.withValue (CommonDataKinds.Phone.NUMBER, phone) 
.withValue (CommonDataKinds.Phone.TYPE, phoneType) 
:build()); 


// 往 data 表 写 人 Email 数据 


ops.add (ContentProviderOperation.newInsert (Data.CONTENT URI) 


try { 


.withValueBackReference (Data.RAW CONTACT ID, 0) 
.withValue (Data .MIMETYPE, 


CommonDataKinds.Email.CONTENT ITEM TYPE) 


.withValue (CommonDataKinds.Email.DATA, email) 
.withValue (CommonDataKinds.Email.TYPE, emailType) 
:build()); 


getContentResolver() .applyBatch (AUTHORITY, ops); 


} catch (Exception e) { 
// 显 式 警告 信息 


Context ctx=getApplicationContext(); 


CharSequence txt=getString(R.string.contactCreationFailure); 
int duration=Toast .LENGTH SHORT7 


Toast toast=Toast.makeText (ctx, txt, duration); 


toast.show(); 


在 代码 8. 8 中 ,第 一 部 分 首先 从 UI 界面 获取 要 插 和 人 记录 的 姓名 .电话 Email, 电话 类 型 
和 Email 类 型 ,然后 创建 新 的 ArrayList 对 象 ops。ops 变量 是 一 个 ContentProviderOperation 


数组 。 这 个 数组 




















来 存放 多 个 数据 库 操作 。 


如 果 要 想 完 成 一 个 操作 ,首先 调用 ContentProviderOperation 的 newInsert() 方 法 创 
建 一 个 构造 插 和 语句 的 Builder 对 象 ,然后 调用 Builder 中 withValue() 方 法 传人 要 插入 


的 列 和 值 。 


ops 数组 一 共有 四 个 ContentProviderOperation 对 象 。 第 一 个 ContentProviderOperation 
对 象 使 用 的 资源 标识 符 为 ContactsContract. RawContacts. CONTENT_URI, 这 个 资源 
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表示 获得 联系 人 信息 的 账号 (可 以 保存 多 个 账号 的 联系 人 信息 ,例如 Gmail 本 地 电话 短 
等 ) ;后面 三 个 ContentProviderOperation 对 象 使 用 的 资源 标识 符 为 ContactsContract. 
Data. CONTENT_URI, 这 个 资源 表示 联系 人 的 元 数据 ,这 里 保存 了 联系 人 的 姓名 、 电 
话 和 Email。 账 号 和 元 数据 之 间 具 有 父子 关系 ,就 是 如 果 删 除 账 号 , 则 与 其 有 关联 的 元 
数据 都 要 被 删除 。 一 般 来 说 ,建立 这 种 关联 关系 的 方法 是 在 元 数据 资源 中 创建 指向 账 
号 资源 主键 的 外 键 。 我 们 通过 withValueBackReference ( ) 方 法 建立 这 种 关系 。 
withValueBackReference() 有 两 个 参数 : 第 一 个 参数 是 字符 串 类 型 ,表示 子 表 外 键 列 名 ; 
第 二 参数 是 int 类 型 ,表示 需要 关联 ops 数组 中 的 哪个 ContentProviderOperation 对 象 ， 
是 ops 数组 的 索引 (从 0 开始 的 整数 ) 。 

ContentProviderOperation 对 象 中 还 包括 newAssertQuery ( ) newDelet ( ) 和 
newUpdate() 等 方法 ,它们 分 别 用 来 实现 查询 判定 (如 果 传人 人 期望值, 可 以 判定 查询 结果 
与 期 望 值 是 否 相 等 ) 删除 和 更 新 的 操作 。 一 旦 提供 了 所 有 的 参数 后 ,就 可 以 使 用 build() 
方法 创建 ContentProviderOperation 对 象 。 

最 后 调用 getContentResolver(). applyBatch() 方 法 ,并 且 传 人 资源 名 称 和 操作 数组 
对 象 ops 执行 所 有 的 操作 。 


8.2.3 预定 义 的 ContentProvider 


Android 系统 预先 定义 了 一 些 ContentProvider, 其 中 包括 : 

Browser: 使 用 Browser ContentProvider 可 以 用 来 读 取 或 修改 标签 .浏览 历史 或 
者 网 络 搜索 。 

CallLog : 查看 或 更 新 电话 历史 ,包括 来 电 和 去 电 、 未 接 来 电 和 电话 细节 ,如 联系 人 
和 通话 时 间 。 

Contact: 使 用 ContactProvider 可 以 用 来 读 取 修改 或 保持 联系 人 信息 。 
MediaStore: 提供 了 对 设备 上 的 多 媒体 文件 的 集中 控制 ,包括 音频 、 视 频 和 图 片 。 
可 以 在 MediaStore 中 保存 自己 的 多 媒体 来 让 它 可 以 全 局 访问 。 

Setting; 可 以 使 用 SettingProvider 来 访问 设备 的 Preference。 使 用 它 ,可 以 查看 
和 修改 蓝牙 设置 .铃声 和 其 他 设备 设 定 。 


8.3 创建 ContentProvider 


前 面 两 节 介绍 了 ContentProvider 的 基础 和 数据 访问 , 如 果 要 定义 一 个 自己 的 
ContentProvider, 需 要 实现 ContentProvider 类 ,并 在 Manifest 文件 中 定义 相应 的 元 素 。 

但 是 创建 ContentProvider 是 一 个 比较 复杂 的 过 程 ,并 非 在 任何 情况 下 都 需要 创建 
ContentProvider。 在 构建 ContentProvider 之 前 ,需要 考虑 一 些 问 题 ,判断 是 否 有 必要 创 
建 Provider。 例 如 需要 向 其 他 应 用 程序 提供 复杂 的 数据 或 文件 吗 ? 需要 复制 复杂 的 数据 
给 其 他 应 用 程序 吗 ? 需要 通过 搜索 框架 提供 定制 的 搜索 建议 吗 ? 如 果 只 是 在 自己 的 应 用 
中 操作 SQLite 数据 库 , 则 不 需要 创建 ContentProvider; 如 果 其 他 应 用 程序 需要 操作 这 部 
分 数据 , 则 需要 创建 ContentProvider。 
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8.3.1 设计 过 程 


下 面 是 建立 一 个 ContentProvider 的 基本 步骤 和 需要 使 用 的 API, 我 们 还 需要 定义 一 
个 Activity 来 测试 ContentProvider 数据 查询 和 操作 。 

1. 选择 存储 结构 

ContentProvider 是 一 个 操作 结构 化 数据 的 接口 。 在 创建 接口 之 前 ,需要 决定 如 何 存 
储 数据 。ContentProvider 可 以 通过 两 种 形式 保存 数据 。 一 种 是 使 用 文件 保存 ,数据 通常 
需要 写 人 文件 ,如 图 片 .音频 、 视 频 。 文 件 存储 在 应 用 程序 的 私有 空间 里 。 为 了 响应 其 他 
应 用 程序 的 请 求 ,ContentProvider 提供 数据 文件 的 句柄 。 还 有 一 种 是 使 用 关系 数据 库 ， 
数据 通常 存储 在 数据 库 ,数组 或 相似 的 结构 中 ,它们 都 是 以 表 的 行列 形式 存储 数据 。 行 代 
表 一 个 实体 ,如 一 个 人 或 仓库 中 的 一 个 产品 。 而 列 代 表 这 个 实体 的 数据 ,如 人 名 、 产 品 的 
价格 。 在 Android 系统 中 ,这 种 类 型 的 数据 通常 是 存储 在 SQLite 数据 库 里 。 在 创建 
ContentProvider 时 ,可 以 根据 所 存储 的 数据 类 型 和 数据 服务 ,选择 适当 的 数据 存储 类 型 。 

如 果 选 择 使 用 文件 存储 数据 ,Android 系统 提供 了 一 系列 有 关 文 件 操作 的 API。 如 
果 ContentProvider 预备 提供 的 数据 是 位 图 文件 或 其 他 类 型 面向 文件 的 数据 ,比较 适合 把 
数据 存储 在 一 个 文件 里 并 且 直 接 提供 ,而 不 是 通过 表 提 供 。 其 他 应 用 程序 在 使 用 这 些 数 
据 时 ,需要 使 用 ContentResolver 文件 方法 来 访问 。 

如 果 选 择 使 用 关系 数据 库存 储 数据 ,Android 系统 提供 了 包含 操作 SQLite 数据 库 的 
API,Android 系统 中 预定 义 的 ContentProvider 就 是 使 用 关系 数据 库 保存 数据 。 
SQLiteOpenHelper 是 创建 数据 库 的 帮助 类 ,SQLiteDatabase 是 访问 数据 库 的 基 类 。 虽 
然 ContentProvider 对 外 的 表现 类 似 关系 数据 库 ,但 是 这 对 于 ContentProvider 的 内 部 实 
现 来 说 并 不 是 必需 的 。 为 了 处 理 基于 网 络 的 数据 ,还 可 以 使 用 java. net 和 android. net 里 
的 API, 把 基于 网 络 的 数据 同步 到 本 地 数据 存储 中 ,并 且 以 表 或 文件 的 形式 提供 数据 。 

选择 了 数据 的 存储 方式 之 后 ,一 个 重要 的 工作 就 是 设计 ContentProvider 表 的 数据 结 
构 。 虽 然 主 键 对 于 一 个 ContentProvider 并 不 是 必须 具备 的 ,即使 有 主键 ,ContentProvider 
也 不 必 一 定 要 使 用 _ID 作为 主键 的 列 名 。 但 是 ,如 果 要 把 ContentProvider 中 的 数据 通过 
用 户 界 面 显示 出 来 ,常常 需要 把 ContentProvider 绑 定 到 一 个 叫做 ListView 的 用 户 界 面 
控件 上 ,这 就 必须 有 一 个 列 名 叫做 _ID。 

在 ContentProvider 支持 的 数据 类 型 中 ,Binary Large OBject (BLOB) 数 据 类 型 用 于 
存储 大 小 变化 或 数据 结构 变化 的 数据 。 例 如 ,可 以 使 用 一 个 BLOB 列 来 存储 一 个 
protocol buffer 或 JSON structure。 对 于 这 种 类 型 的 数据 ,可 以 使 用 BLOB 来 实现 一 个 
独立 模式 的 表 , 定 义 一 个 主键 和 一 个 MIME 类 型 的 列 , 其 他 列 定义 为 BLOB,BLOB 列 里 
的 数据 意义 由 MIME 列 来 指定 。 这 样 我 们 可 以 在 同一 张 表 里 存 储 不 同 的 数据 类 型 。 

2. 定义 资源 标识 条 

每 一 个 ContentProvider 都 使 用 资源 标识 符 Content URI 来 指定 其 中 的 数据 。 通 过 
资源 标识 符 ,不仅 可 以 唯一 地 确定 提供 数据 的 ContentProvider, 还 可 以 通过 其 中 的 路 径 
来 指定 ContentProvider 中 的 表 , 甚 至 可 以 使 用 ID 确切 地 访问 指定 表 中 的 唯一 行 。 而 且 
ContentProvider 中 的 每 个 方法 都 有 一 个 资源 标识 符 作 为 参数 ,可 以 用 来 确定 需要 访问 的 
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表 、 行 和 文件 。 因 此 定义 资源 标识 符 是 创建 ContentProvider 很 重要 的 部 分 。 

定义 资源 标识 符 主要 考虑 下 面 几 个 问题 : 

(1) ContentProvider 资源 名 的 定义 。 

在 Android 系统 中 ,ContentProvider 应 该 具有 唯一 的 资源 名 ,作为 其 在 Android 里 
的 内 部 名 。 为 了 避免 资源 名 的 重复 ,资源 名 通常 采用 域名 的 格式 。 由 于 应 用 程序 的 包 名 
也 是 按照 这 种 格式 设计 的 ,因此 可 以 通过 扩展 包 名 的 方式 定义 资源 名 。 例 如 ,应 用 程序 的 
包 名 为 com. example. < appname 二 ,那么 资源 名 称 就 可 以 定义 为 com. example. 
—appname>2.. provider, 

(2) 资源 标识 符 的 路 径 结构 。 

开发 人 员 通 常 从 资源 名 开始 ,在 后 面 追加 路 径 来 指向 具体 的 表 。 例 如 ,在 Provider 
中 设计 了 两 张 表 tablel 和 table2 ,就 可 以 使 用 下 面 的 路 径 结构 来 指定 对 应 的 资源 : com. 
example. <appname>. provider/tablel 和 com. example. <appname>. provider/table2 。 
路 径 可 以 有 多 个 层次 ,不 一 定 每 个 层次 都 指向 表 。 

(3) 处 理 资源 标识 符 中 的 ID. 

按照 约定 ,通过 使 用 带 有 ID 值 的 资源 标识 符 可 以 访问 表 中 指定 的 一 行 。 这 个 ID 在 
资源 标识 符 的 末尾 。 一 般 来 说 ,ContentProvider 的 ID 值 与 表 中 的 _ID 值 匹 配 , 可 以 用 来 
操作 对 应 的 数据 行 。 当 应 用 程序 访问 ContentProvider 时 ,这 个 约定 是 一 个 通用 的 设计 模 
式 。 应 用 程序 从 ContentProvider 中 查询 数据 返回 游标 对 象 ,并 且 利用 CursorAdapter 在 
ListView 中 显示 结果 。 定 义 CursorAdapter 时 ,需要 游标 中 有 一 列 为 ID。 如 果 用 户 选 
取 了 ListView 中 的 一 行 , 希 望 可 以 查询 或 者 修改 对 应 的 数据 ,这 就 需要 应 用 程序 从 
ListView 的 后 台 游 标 中 得 到 这 行 -ID 值 ,然后 附加 到 资源 标识 符 的 后 面 ,然后 发 送 访问 请 
求 给 ContentProvider ,这 样 来 完成 对 某 一 行 数据 的 查询 或 修改 。 

3. 资源 标识 符 模式 

不 同 资源 标识 符 的 模式 对 应 不 同 的 操作 ,所 以 需要 识别 不 同 资源 标识 符 的 模式 。 
Android 的 API 中 包含 一 个 UriMatcher 类 ,用 来 定义 不 同 资源 标识 符 的 匹配 模式 。 这 个 
类 把 资源 标识 符 的 模式 映射 到 一 个 整数 ,这 样 应 用 程序 在 switch 语句 中 可 以 匹配 对 应 整 
数 来 选择 对 应 的 操作 。 在 做 匹配 的 过 程 中 ,资源 标识 符 模 式 使 用 了 通配符 ,其 中 “* ”匹配 
一 个 字符 串 , 可 以 任何 长 度 的 任何 值 ;“# ?匹配 一 个 字符 串 , 可 以 是 任何 长 度 的 数字 。 

下 面 举例 设计 一 组 资源 标识 符 ,并 且 通 过 编码 处 理 资源 标识 符 。 

假定 有 一 个 ContentProvider 的 资源 名 为 com. example. app. provider, 下 面 的 资源 标 
识 符 则 指向 具体 的 表 : 


content://com.example.app.provider/tablel: A table calledtablel 
content://com. example. app. provider/table2/datasetl: A table called 
dataset1 

content://com. example. app. provider/table2/dataset2: A table called 
dataset2 

content://com.example.app.provider/table3: A table called table3 


`> 


` 
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如 果 在 上 述 的 资源 标识 符 后 面 加 上 ID, 例 如 content://com. example. app. provider/ 
table3/1 则 表示 表 table3 中 主键 为 1 的 行 。 对 于 com. example. app. provider 来 说 ,以 下 
资源 标识 符 的 模式 都 是 可 用 的 : 


content://com.example.app.provider/* 

表示 匹配 Provider 的 任何 资源 标识 符 。 
content://com.example.app.provider/table2/* 

表示 匹配 datasetl 和 dataset2 的 资源 标识 符 , 不 匹配 表 tablel 或 table3 的 资源 标识 符 。 
content://com.example.app.provider/table3/# 


表示 匹配 table3 中 某 行 的 资源 标识 符 。 

代码 8. 9 示例 了 UriMatcher 的 方法 如 何 完成 模式 的 匹配 。 这 段 代 码 中 ,针对 表 的 资 
源 标识 符 与 单行 的 资源 标识 符 实现 了 不 同 的 处 理 方式 ,其 中 定义 content: / /< authorityZ>/ 
二 path 过 模式 为 表 , 定 义 content: //<authority>/<path>/<id> RAMIT. 

UriMatcher 的 addURI() 方 法 把 资源 名 和 路 径 映 射 到 一 个 整数 。match() 方 法 返回 
了 对 应 资源 标识 符 的 整数 。 然 后 通过 一 个 switch 语句 根据 不 同 整数 来 对 应 不 同 的 模式 ， 
选择 查询 表 或 者 单个 记录 。 

addURI() 方 法 的 参数 说 明 如 下 

* String authority: Content URI 的 authority 部 分 ,也 就 是 资源 名 。 

。 String path: Content URI 的 path 部 分 ,详细 的 表 或 记录 路 径 。 

。 int code; 模式 对 应 整数 。 

代码 8.9 定义 和 使 用 资源 标识 符 模式 


public class ExampleProvider extends ContentProvider { 
// 定 义 常 量 
private static final int PEOPLE=1; 
private static final int PEOPLE_ID=2; 
private static final int PEOPLE PHONES=3; 
private static final int PEOPLE PHONES ID=4; 
private static final int PEOPLE CONTACTMETHODS=7; 
private static final int PEOPLE CONTACTMETHODS ID=8; 


private static final int DELETED PEOPLE=20; 
private static final int PHONES=9; 
private static final int PHONES ID=107 


private static final int PHONES_FILTER=14; 


private static final int CONTACTMETHODS=18; 
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return "vnd.android.cursor.dir/snail-mail"; 
case PEOPLE_ADDRESS_ID: 

return "vnd.android.cursor.item/snail-mail"; 
default: 


return null; 


} 


另外 ,ContentUris 类 提供 了 处 理 资源 标识 符 中 ID 部 分 的 方法 , Uri 和 Uri. Builder 
类 中 包含 解析 Uri 对 象 , 或 者 构建 新 对 象 的 方法 。 

4. 定义 Contract 类 

Contract 类 , 即 合约 类 ,是 一 个 final public 的 类 ,主要 用 于 定义 Provider 使 用 的 常 
量 ,例如 资源 标识 符 、 表 名 、 列 名 、MIME 类 型 和 其 他 一 些 媒体 数据 等 。Contract 类 在 
Provider 和 其 他 应 用 程序 之 间 建 立 了 一 个 契约 ,保证 Provider 的 数据 资源 能 够 被 这 些 程 
序 正 确 访 问 。 这 样 , 即 使 Provider 中 的 这 些 常量 中 的 值 有 变化 ,也 不 会 影响 外 部 程序 的 
使 用 。 

由 于 Contract 类 通常 使 用 带 有 语义 的 名 字 来 命名 常量 ,可 以 帮助 开发 人 员 减 少 使 用 
列 名 或 资源 标识 符 的 错误 ,而 且 还 可 以 包含 文档 。 集 成 开发 环境 (例如 Eclipse) 可 以 帮助 
开发 人 员 选 取 常 量 名 ,并 且 显 示 相 关 文 档 。 

外 部 程序 的 开发 者 从 应 用 程序 中 不 能 访问 Contract 类 的 class 文件 ,但 在 编译 时 ,可 
以 静态 编译 到 应 用 程序 中 去 。 

5. 定义 MIME 类 型 

ContentProvider 类 有 两 个 方法 返回 MIME 类 型 。 一 个 是 getType() ,这 是 必须 实现 
的 方法 。 另 一 个 为 getStreamTypes() ,如 果 Provider 提供 文件 类 型 数据 ,就 需要 实现 这 
个 方法 。 

getType() 方 法 返回 一 个 MIME 格式 的 字符 串 ,这 个 字符 串 描述 了 资源 标识 符 参 数 
对 应 的 数据 类 型 。 资 源 标 识 符 参 数 可 以 是 一 个 具体 的 标识 符 , 也 可 以 是 一 个 模式 。 如 果 
参数 为 模式 , 则 需要 返回 与 这 种 模式 相 匹配 的 资源 标识 符 关 联 的 数据 类 型 。 

如 果 是 通常 的 数据 类 型 ,例如 text, HTML 或 者 JPEG,getType() 方 法 返回 标准 的 
MIME 类 型 。 这 些 类 型 可 从 官方 的 网 站 (http://www. iana. org/assignments/media- 
types) 上 查找 。 

如 果 是 表 中 一 行 或 多 行 数据 类 型 ,getType() 方 法 返回 Android 特定 的 MIME 格式 : 

(1) type 部 分 : vnd。 

(2) 子 类 型 部 分 ， 

。 单行 的 URI 模式: android. cursor. item/; 

。 多 行 的 URI 模式 : android. cursor. dir/。 

(3) Provider 说 明 的 部 分 : vnd. <name>. <type>2>, jJEriB name 值 必须 是 全 局 唯一 
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的 ,type 值 必须 对 应 一 个 资源 标识 符 的 模式 。name 可 以 选择 公司 的 名 字 或 应 用 程序 包 
的 部 分 名 字 。type 最 好 标识 可 以 关联 资源 标识 的 表 。 

例如 ,Provider 的 资源 名 为 com. example. app. provider, 表 名 是 tablel , 则 表示 tablel 
表 里 多 行 数据 的 MIME 类 型 是 : 


vnd.android.cursor.dir/vnd.com.example.provider.tablel 
如 果 表示 tablel 表 的 单行 ,MIME 类 型 是 : 
vnd.android.cursor.item/vnd.com.example.provider.tablel 


如 果 Provider 支持 的 是 文件 类 型 数据 ,需要 实现 getStreamTypes() 方 法 。 这 个 方法 
会 根据 资源 标识 符 参数 从 Provider 中 返回 包含 MIME 类 型 的 字符 串 数组 。 我 们 可 以 通 
过 参数 来 过 滤 MIME 类 型 , 仅 返 回 客户 端 可 以 处 理 的 MIME 类 型 。 

例如 ,假定 Provider 支持 . jpg.. png 和 . gif 格式 的 图 片 文 件 。 当 应 用 程序 调用 
ContentResolver. getStreamTypes() 方 法 时 ,如 果 使 用 过 滤 字 符 串 image/ * ,表示 这 是 一 
IKEI 片 , ContentProvider. getStreamTypes() 方 法 返回 的 数组 内 容 为 {"image/jpeg"， 
"image/png" , "image/gif" ) ;如果 应 用 程序 仅仅 需要 文件 . jpg. 调用 ContentResolver. 
getStreamTypes() 方 法 时 使 用 过 滤 字 符 串 * /jpeg, 则 返回 的 结果 为 {"image/jpeg"}。 如 
果 Provider 中 没有 支持 过 滤 字 符 串 的 MIME 类 型 ,getStreamTypes() 方 法 返回 null。 

6. 实现 ContentProvider 的 子 类 

定义 自己 的 ContentProvider, 需 要 创建 ContentProvider 的 子 类 ,使 用 ContentProvider 
实例 来 处 理 其 他 应 用 的 访问 请 求 , 并 且 管 理 结构 化 数据 的 访问 。 所 有 对 Provider 数据 的 访 
问 ,都 通过 所 创建 ContentResolver 对 象 ,调用 操作 数据 的 方法 ,最 终 调用 ContentProvider 中 
的 具体 方法 来 实现 。 

因此 ,在 子 类 里 需要 代码 实现 ContentProvider 提供 六 个 抽象 方法 ,具体 来 完成 对 
Provider 的 数据 操作 。 这 六 个 抽象 方法 包括 query() insert () , delete ( ), update (), 
getType()(8. 3. 1 节 已 介绍 这 里 不 再 介绍 ) 和 oncreate() 。 除 了 onCreate() ,其 他 方法 都 
会 被 访问 ContentProvider 的 客户 端 应 用 程序 调用 。 

1) query() 

用 来 从 Provider 获取 数据 。 通 过 参数 来 选择 查询 的 表 、 返 回 行 或 列 、 结 果 排序 。 方 
法 的 查询 结果 返回 游标 对 象 。 如 果 使 用 SQLite 数据 库存 储 数 据 , 可 以 使 用 
SQLiteDatabase 类 的 query() 方 法 来 返回 游标 对 象 。 如 果 没 有 匹配 的 行 ,也 返回 游标 对 
象 ,但 是 其 getCount() 方 法 返回 值 为 0。 如 果 在 查询 中 出 现 内 部 错误 ,将 返回 null。 如 果 
没有 使 用 SQLite 数据 库 保 存 数据 , 可 以 使 用 一 个 Cursor 类 的 具体 子 类 。 例 如 ， 
MatrixCursor 类 实现 了 游标 的 功能 ,其 中 每 行 数据 是 数组 ,可 以 使 用 addRow() 方 法 添加 
新 行 。 

另外 ,由 于 用 户 程 序 访问 ContentProvider 是 跨 进程 通信 ,因此 在 进程 间 传 递 异常 信 
息 是 非常 重要 的 。lllegalArgumentException 和 NullPointerException 可 以 在 进程 间 通 
信 , 而 且 对 于 处 理 查 询 异常 是 非常 有 帮助 的 。 
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2) insert() 

用 来 向 ContentProvider 插入 新 行 。 使 用 参数 选择 表 ,获取 使 用 的 列 值 ,返回 一 个 新 
插入 行 的 资源 标识 符 。insert() 方 法 向 合适 的 表 里 添加 行 , 使 用 ContentValues 对 象 为 列 
设置 值 。 如 果 ContentValues 里 没有 行 名 ,ContentProvider 使 用 代码 里 或 者 数据 库 框 架 
里 的 默认 值 。 

这 个 方法 返回 新 行 的 资源 标识 符 。 使 用 withAppendedId() 方 法 将 新 行 的 _ID( 或 其 
他 主键 ) 附 加 到 表 的 资源 标识 符 后 面 。 

3) delete() 

用 来 删除 行 。 使 用 参数 选择 删除 的 表 和 行 ,返回 结果 为 删除 的 行 数 。delete() 方 法 
没有 必要 物理 地 删除 行 。 

4) update() 

用 来 更 新 存在 的 行 。 使 用 参数 选择 需要 更 新 的 表 和 行 ,然后 更 新 其 中 列 的 值 , 返 回 结 
果 为 更 新 的 行 数 。update() 方 法 使 用 与 insert () 方 法 相同 的 ContentValues 参数 ,与 
delete() 和 query() 方 法 使 用 相同 的 selection 和 selectionArgs 参数 。 这 样 就 可 以 允许 在 
这 些 方法 之 前 使 用 相同 的 代码 。 

5) onCreate() 

初始 化 ContentProvider。Android 系统 在 创建 ContentProvider 之 后 就 立即 调用 这 
个 方法 。 注 意 直到 ContentResolver 对 象 需要 访问 时 ,ContentProvider 才 创 建 。 

由 于 Android 系统 在 ContentProvider 启动 的 时 候 调 用 onCreate() 方 法 ,因此 
onCreate() 不 能 有 耗 时 太 多 的 代码 ,避免 延迟 数据 库 的 创建 和 数据 加 载 。 如 果 在 
onCreate() 里 有 耗 时 太 多 的 任务 ,会 减 慢 ContentProvider 的 启动 ,也 就 会 减 慢 其 对 其 他 
应 用 程序 的 响应 。 

下 面 一 个 例子 说 明 如 何 实现 ContentProvider 的 这 些 方法 。 这 个 例子 实现 了 在 方法 
ContentProvider. onCreate() 里 创建 一 个 新 的 SQLiteOpenHelper 对 象 来 使 用 数据 库 ,在 
打开 数据 库 的 时 候 创 建 表 。 这 样 ,第 一 次 调用 getWritableDatabase() 时 ,会 自动 调用 方 
法 SQLiteOpenHelper. onCreate() 。 代 码 8. 10 实现 ContentProvider. onCreate() 方 法 。 

代码 8.10 实现 ContentProvider. onCreate() 方 法 


public class ExampleProvider extends ContentProvider 


//Defines a handle to the database helper object. 
private MainDatabaseHelper mOpenHelper; 


//Defines the database name 
private static final String DBNAME="mydb"; 


//Holds the database object 
private SQLiteDatabase db; 


public boolean onCreate () ( 





以 下 代码 实现 SQLiteOpenHelper. onCreate() ; 
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/x% 
* Helper class that actually creates and manages the provider's underlying 
data repository. 
*/ 

protected static final class MainDatabaseHelper extends SQLiteOpenHelper { 


MainDatabaseHelper (Context context) { 
super (context, DBNAME, null, 1); 
j; 


/* 
* Creates the data repository. This is called when the provider attempts 
to open the 
* repository and SQLite reports that it doesn't exist. 
* / 
public void onCreate (SOLiteDatabase db) { 


//Creates the main table 
db .execSQL (SQL CREATE MAIN); 


} 


通过 这 个 例子 ,可 以 看 出 ContentProvider. onCreate ( ) 和 SQLiteOpenHelper. 
onCreate() 的 相互 调用 。 在 实现 ContentProvider 的 抽象 方法 时 ,除了 onCreate() 外 , 需 
要 考虑 线程 安全 。 
7. 定义 访问 权限 
针对 不 同类 型 的 存储 方式 , Android 系统 的 存储 安全 和 有 效 的 权限 的 要 点 有 下 面 
is 
。 默认 情况 下 ,在 内 部 存储 的 数据 文件 对 其 应 用 程序 和 ContentProvider 是 私有 的 。 
。 外 部 存储 的 数据 文件 是 公开 的 。 无 法 使 用 ContentProvider 限制 其 他 程序 访问 外 
部 存储 中 的 文件 ,其 他 应 用 程序 可 以 使 用 API 读 写 它们 。 
。 在 内 部 存储 的 文件 或 是 SQLite 数据 库 , 可 以 由 创建 它 的 应 用 程序 潜在 地 把 读 和 
写 的 权限 付 给 其 他 的 应 用 程序 。 如 果 要 使 用 内 部 文件 或 数据 库 作为 
ContentProvider 的 数据 源 ,必须 在 Manifest 文件 中 设置 权限 ,把 其 访问 权限 设 为 
world-readable 或 world-writeable, 这 些 数据 将 不 再 受到 保护 。 默 认 情 况 下 内 部 
存储 器 文件 和 数据 库 的 访问 权限 是 private, 对 于 ContentProvider 也 不 应 该 改变 。 
如 果 要 使 用 ContentProvider 的 权限 来 控制 对 数据 的 访问 ,就 应 该 将 数据 存储 在 内 部 
文件 .SQLite 数据 库 , 或 “ 云 ”( 例 如 ,在 远程 服务 器 上 ) 的 数据 中 ,并 保持 文件 和 数据 库 的 
private 存储 访问 权限 。 
怎样 进行 ContentProvider 的 权限 控制 呢 ? 
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如 果 不 做 任何 权限 设置 ,所 有 的 应 用 程序 可 以 读 取 或 写 和 人 ContentProvider, 即 使 这 
些 数据 的 存储 访问 权限 是 私有 的 ,因为 默认 情况 下 ContentProvider 没有 权限 集 。 
ContentProvider 的 权限 集 需要 在 Manifest 中 ,使 用 ContentProvider 的 属性 和 子 元 素来 
设置 。 在 这 里 可 以 设置 应 用 于 整个 ContentProvider、 特 定 的 表 、 单 一 的 记录 或 满足 某 些 
条 件 权限 。 

在 Manifest 文件 中 ,可 以 使 用 一 permission 二 元 素 为 ContentProvider 定义 一 个 或 
多 个 访问 权限 。 为 了 这 些 权限 的 唯一 性 ,可 以 用 Java 包 名 的 方式 定义 android; name 属 
性 。 例 如 ,指定 读 权限 的 com. example. app. provider. permission. READ_PROVIDER 。 

下 面 是 ContentProvider 数据 范围 由 大 到 小 的 权限 设置 : 

* 读 写 ContentProvider 级 别 的 权限 : 控制 整个 ContentProvider 的 读 写 权限 ,使 用 
一 provider 二 元素 的 android: permission 属性 指定 。 

读 或 写 ContentProvider 级 别 的 权限 : 控制 整个 ContentProvider 的 读 权限 或 写 权 
BB. 使 用 < provider 之 元素 的 android: readPermission 属性 或 android: 
writePermission 属性 来 设 定 。 

路 径 级 别 权 限 : 对 于 ContentProvider 中 的 Content URI 指 定数 据 的 读 、 写 或 读 / 
写 权 限 。 使 用 一 provider 过 的 子 元 素 二 path-permission 过 来 指定 要 控制 的 每 个 
URI 数 据 的 访问 权限 。 在 权限 设置 时 ,可 以 针对 每 个 Content URI, 指定 一 个 读 / 
HRR . 读 权 限 或 写 权 限 ,或 所 有 三 个 权限 。 其 中 读 取 和 写 人 权限 覆盖 读 / 写 权 
限 , 并 且 路径 级 别 的 权限 覆盖 Provider 级 别 的 权限 。 

临时 权限 : 对 于 临时 访问 的 应 用 程序 指定 的 权限 。 这 个 权限 也 适用 于 通常 没有 
所 需 权 限 的 应 用 程序 。 临 时 访问 功能 减少 了 应 用 程序 在 其 Manifest 中 请 求 权 限 
的 数量 。 使 用 元 素 的 android:grantUriPermissions 属性 ,或 者 一 provider 之 的 子 元 
素 一 grant-urirpermission 二 来 设置 临时 权限 。 如 果 使 用 临时 权限 ,无 论 什 么 时 候 从 
Provider 中 删除 Content URI 数据 ,都 必须 调用 Context. revokeUriPermission ( ) 
方法 ,因为 这 个 Content URI 拥 有 临时 权限 。 如 果 android: grantUriPermissions 
属性 没有 设置 ,默认 就 是 false, 

与 Activity 和 Service 组 件 一 样 ,ContentProvider 的 子 类 也 必须 在 其 应 用 程序 的 
Manifest 文件 中 进行 声明 ,才能 够 在 系统 中 起 作用 。 在 Manifest 文件 中 声明 
ContentProvider 的 元 素 为 一 provider 二 ,使 用 android: name 说 明 ContentProvider 的 名 
称 。 除 了 前 面 所 提 到 的 访问 权限 的 属性 和 元 素 ,还 包括 其 他 属性 。 


8.3.2 设计 实例 


上 面 介 绍 了 ContentProvider 设计 和 创建 的 方法 ,下 面 是 一 个 ContentProvider 的 
实例 。 

1. 创建 ContentProvider 

为 了 更 好 地 理解 设计 ContentProvider 的 原则 ,我 们 用 一 个 完整 的 例子 来 讲解 创建 一 
个 Provider 的 过 程 。 
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这 个 例子 的 ContentProvider 创建 ,是 基于 第 7 章 的 SOLite 学 生 信息 数据 库 , 这 个 数 
据 库 包 括 两 张 表 Students 和 Departments, 这 两 个 表 之 间 有 外 键 约束 。 下 面 按照 前 一 节 
的 设计 过 程 ,逐步 进行 完成 ContentProvider 的 创建 。 

(1) 选择 储存 结构 。 

选择 SQLite 数据 库 。 

(2) 定义 资源 标识 符 。 

根据 第 7 章 SQLite 数据 库 中 定义 的 数据 表 ,和 自己 定义 的 前 级 定义 所 要 创建 的 
Provider 的 Content URI 如 下 : 


content://com.pinecone.technology.studentprovider/students 
content://com.pinecone.technology.studentprovider/departments 


这 个 定义 在 Contract 类 中 实现 。 

(3) 定义 资源 标识 符 模式 。 

在 ContentProvider 类 内 代码 的 第 一 部 分 定义 资源 标识 符 模 式 , 前 一 部 分 是 常量 定 
义 , 后 一 部 分 模式 定义 见 代 码 8.11. 

代码 8. 11 定义 资源 标识 符 模式 


private static final String STUDENT TABLE="students"; 
private static final String DEPARTMENT_TABLE="departments"; 


private static final int STUDENT=1; 
private static final int STUDENT_ID=2; 
private static final int DEPARTMENT=3; 
private static final int DEPARTMENT_ID=4; 
private static final UriMatcher MATCHER; 


static ( 
MATCHER=new UriMatcher (UriMatcher.NO_MATCH) ; 
MATCHER.addURI (StudentsContract.AUTHORITY, "student", STUDENT); 
MATCHER.addURI (StudentsContract.AUTHORITY, "student/#", STUDENT_ 
ID); 
MATCHER.addURI (StudentsContract.AUTHORITY, "department", 
DEPARTMENT); 
MATCHER.addURI (StudentsContract .AUTHORITY, "department/#", 

DEPARTMENT ID); 
j: 


(4) 定义 Contract 类 。 
根据 ContentProvider 的 需要 ,定义 一 些 常量 ,例如 Content URI、 表 名 和 列 名 , 见 代 
码 8.12。 
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代码 8.12 StudentsContract. java 
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(5) 定义 MIME 类 型 。 对 应 这 个 例子 的 两 个 表 ,定义 四 个 MIME 类 型 ; 





这 四 个 MIME 类 型 在 StudentsContract 类 中 定义 为 常量 ( 见 代码 8. 12) 。 

(6) 定义 ContentProvider。 

定义 ContentProvider 的 子 类 StudentsProvider, 首 先 定 义 资源 标识 符 模 式 ,然后 具 
体 实现 ContentProvider 的 六 个 抽象 方法 onCreate() ,insert() .update() delete© .query() 
和 getType()( 见 代码 8.13), 

代码 8.13 StudentsProvider. java 
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(7) 定义 访问 权限 。 
ContentProvider 的 访问 权限 在 Manifest 文件 中 声明 二 provider 二 时 定义 。 默 认 状 
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态 下 ,所 有 的 其 他 应 用 程序 都 可 以 访问 这 个 ContentProvider。 
2. 注册 ContentProvider 
最 后 要 在 Manifest 文件 中 注册 ContentProvider: 


<provider 
android:name=".StudentsProvider " 
android:authorities="com.androidbook.provider.StudentsProvider " /> 


8.4 实现 数据 加 载 


在 前 面 的 章节 中 ,查看 数据 库 的 查询 结果 或 Provider 提供 的 数据 时 ,每 次 查询 的 结 
果 并 不 确定 ,需要 实现 数据 的 动态 加 载 。Android 针对 这 一 类 的 数据 提供 了 一 个 机 制 , 叫 
数据 绑 定 。 通 过 数据 绑 定 , 可 以 把 动态 的 数据 与 称 为 AdapterView 的 图 形 控件 连接 起 
来 ,并 自动 根据 数据 的 内 容 进 行 布 局 调整 ,按照 某 种 规则 显示 给 用 户 。 在 数据 源 和 
AdapterView 之 间 起 连接 作用 的 类 ,在 Android 系统 中 称 为 适配器 (Adapter) 。 

当 想 用 合适 的 方式 显示 并 操作 一 些 数 据 ( 如 数组 ,链表 ,数据 库 等 ) 时 ,可 以 使 用 提供 
Android 适配器 的 视图 (AdapterView) ,这 种 方式 叫 数据 绑 定 ( 见 图 8. 2) 。 


AdapterView k= Adapter k=] Data Source | 


图 8.2 Adapter 工作 原理 











适配器 就 相当 于 一 个 通道 ,加 了 一 些 规则 的 通道 , 它 可 以 使 得 流 过 通道 的 数据 按照 某 
种 规则 呈现 出 来 。 适 配器 是 数据 与 数据 显示 控件 (如 ListView、Gallery、Spinner) 之 间 的 
桥梁 ,用 来 将 数据 绑 定 到 显示 控件 上 进行 显示 。 例 如 ,USB 是 一 个 适配器 , 它 有 一 些 读 取 
数据 的 规则 ,如 果 插 和 人 鼠标 , 则 系统 会 通过 USB 获取 的 信息 识别 其 是 鼠标 ,系统 可 以 对 鼠 
标的 操作 做 出 反应 ;如 果 是 U 盘 , 系 统 会 通过 USB 获取 的 信息 识别 其 是 U 盘 ,可 以 对 它 
进行 信息 存 取 操作 。 这 里 的 USB 就 相当 于 适配器 ,鼠标 或 U 盘 的 信息 ,就 是 系统 通过 适 
配器 获取 的 数据 。 同 样 的 道理 ,通过 Android 适配器 的 作用 ,Android 系统 会 识别 出 是 数 
组 还 是 数据 库 的 数据 ,并 根据 适配器 传递 的 信息 做 出 合适 的 显示 。 

Android 提供 多 种 适配器 ,开发 时 可 以 针对 数据 源 的 不 同 采用 最 方便 的 适配器 ,也 可 
以 自 定义 适配器 完成 复杂 功能 。 使 用 这 种 机 制 , 就 可 以 把 前 面 Provider 的 数据 从 用 户 界 
面 上 显示 出 来 了 。 

下 面 首先 介绍 数据 绑 定 的 基本 原理 ,然后 介绍 适合 数据 库 数据 显示 的 ListView 图 形 
控件 。 


8.4.1 基本 原理 
AdapterView 是 ViewGroup 的 子 类 ,其 中 画廊 (Gallery)、 列 表 视 图 (ListView) 、 微 调 
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框 控件 (Spinner) 和 网 格 视图 (GridView) 等 都 是 适配器 视图 AdapterView 子 类 的 例子 ， 
用 来 绑 定 到 特定 类 型 的 数据 并 以 一 定 的 方式 显示 。AdapterView 对 象 有 两 个 主要 责任 : 
用 数据 填充 布局 和 响应 用 户 的 选择 事件 。 

常见 的 适配器 有 SimpleAdapter、SimpleCursorAdapter、ArrayAdapter。 从 名 称 可 以 
看 出 ArrayAdapter 使 用 数组 作为 数据 源 ,SimpleCursorAdapter 使 用 游标 作为 数据 源 , 而 
SimpleAdapter 将 一 个 List 作为 数据 源 ,可 以 让 ListView 进行 更 加 个 性 化 的 显示 。 

下 面 使 用 Android 下 拉 菜单 Spinner 控件 ,来 举例 说 明 数 据 绑 定 的 机 制 。 

(1) 设置 应 用 的 布局 文件 。 

首先 设计 用 户 图 形 界面 的 布局 文件 ,把 显示 数据 结果 的 Spinner 控件 作为 界面 中 的 
一 个 组 件 ( 见 代码 8.14). 

代码 8.14 布局 文件 c07_spinner. xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical"> 
<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:layout marginTop="10dip" 
android:text="@string/planet prompt" /> 


<Spinner 
android:id="@+id/spinner" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:drawSelectorOnTop="true" 
android:prompt="@string/planet_prompt" /> 


</LinearLayout> 


(2) 在 Activity 中 获得 Spinner 控件 对 象 。 
在 定义 用 户 界面 的 Activity 子 类 中 ,通过 布局 文件 代码 8. 14 中 所 定义 的 Spinner 的 
ID, 在 onCreate() 方 法 中 使 用 findViewById() 获 取 Spinner 对 象 。 代 码 如 下 : 


setContentView(R.layout .c07 spinner); 
Spinner s= (Spinner) findViewById(R.id.spinner); 


(3) 实现 Spinner 与 数据 源 的 数据 绑 定 。 
获取 Spinner 对 象 后 ,在 此 Activity 子 类 的 onCreate() 方 法 内 实现 数据 绑 定 。 
首先 为 Spinner 控件 创建 适配器 ,获得 arrays. xml 资源 文件 中 数组 planets; 接 下 来 
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将 数据 显示 界面 声明 为 android. R. layout. simple_spinner_item 布局 模式 ,将 此 适配器 与 
控件 对 象 绑 定 。 这 个 模式 是 为 Spinner 类 预定 义 好 的 布局 模式 。 然 后 创建 下 拉 菜 单 ( 见 
代码 8. 15). 
代码 8.15 创建 适配器 


ArrayAdapter<CharSequence>adapter=ArrayAdapter.createFromResource (this, 
R.array.planets, android.R.layout.simple_spinner_item); 
adapter.setDropDownViewResource (android.R.layout.simple_spinner_dropdown 
_item); 

s.setAdapter (adapter) ; 


适配器 ArrayAdapter 是 适用 于 数组 数据 的 适配器 ,用 外 部 数据 创建 一 个 适配器 对 象 
可 以 使 用 其 createFromResource() 方 法 。 其 参数 说 明 如 下 : 

* Context context; 应 用 程序 的 环境 。 

。 int textArrayResId: 作为 数据 源 的 数组 。 

。 int textViewResId: 用 于 创建 视图 的 布局 模式 。 

创建 下 拉 菜 单 使 用 ArrayAdapter 的 setDropDownViewResource() 方 法 ,其 参数 为 
int resource, 意 即 布局 资源 定义 的 下 拉 菜 单 视图 。 

(4) 定义 数据 源 数 组 。 

在 资源 文件 arrays. xml 文件 中 定义 数组 planets, 并 设置 数组 值 ( 见 代码 8.16). 

代码 8.16 arrays. xml 


<resources> 

<string name="app name">Spinner</string> 
<string-array name="planets"> 
<item>Mercury</item> 

<item>Venus</item> 

<item>Earth</item> 

<item>Mars</item> 

<item>Jupiter</item> 
<item>Saturn</item> 

<item>Uranus</item> 
<item>Neptune</item> 

<item>Pluto</item> 

</string-array> 

<string name="planet prompt">Select a planet</string> 
</resources> 


运行 这 个 例子 程序 ,就 得 到 图 8. 3 显示 的 界面 。 这 里 的 数据 源 ,也 就 是 arrays 中 定 
义 的 planets 数组 ,通过 ArrayAdapter 这 个 适配器 ,与 Spinner 这 个 图 形 显示 控件 联系 起 
来 ,使 数组 数据 直接 按照 列表 的 形式 显示 ,不 必 再 做 布局 的 设计 。 这 个 功能 就 是 填充 布局 
的 作用 。 


ef HF Androd 平台 的 移动 互联 网 应 用 开发 ($ 218) 
— 





° Select a planet 


Earth 


Mars 


Jupiter 


Saturn 


Uranus 


Neptune 





8.3 通过 数组 给 列表 赋值 


如 果 布 局 是 动态 的 或 者 非 预定 义 的 ,可 以 在 运行 时 使 用 一 个 布局 子 类 AdapterView 
来 填充 布局 。AdapterView 类 的 子 类 使 用 一 个 适配器 将 数据 绑 定 到 它 的 布局 。 适 配器 把 
数据 源 和 AdapterView 布局 之 间 连 接 起 来 ,适配器 检索 数据 ,例如 把 数据 从 数组 或 者 数 
据 库 提取 出 来 ,将 其 转换 成 可 以 添加 到 AdapterView 布局 视图 中 的 条 目 。 

通用 的 适配器 布局 包括 ListView( 图 8. 4 左 图 ) 和 Grid View( 图 8. 4 ARI). 





图 8.4 ListView 和 GridView 显示 效果 


8.4.2 ListView 控件 


ListView 是 AdapterView 的 子 类 ,用 于 列表 显示 。ListView 的 定义 有 两 种 方式 : 

。 继承 ListActivity 类 ,使 用 其 内 置 的 ListView 对 象 。 

° 在 布局 文件 中 定义 自 定义 视图 的 List View, 
ListActivity 是 一 个 专门 显示 ListView 的 Activity 类 , 它 内 置 了 ListView 对 象 ,只 


要 设置 了 数据 源 ,就 会 自动 地 显示 出 来 。 虽 然 ListActivity AET ListView 对 象 ,但 依然 
可 以 在 布局 文件 中 自 定义 视图 。 
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自 定义 视图 时 ,在 布局 文件 中 要 注意 设置 ListView 对 象 的 id 为 "@id/android:list "; 
而 在 Java 代码 里 使 用 android. R. id. list 来 引用 ListView 视图 。 在 使 用 ListActivity 来 
显示 ListView 视图 时 ,如 果 使 用 了 自 定义 的 布局 文件 ,通过 setContentView() 方 法 进行 
绑 定 ;如 果 不 使 用 自 定义 的 布局 文件 ,这 个 步骤 可 以 省 略 。 
Android 系统 提供 了 多 种 模板 进行 选择 ,例如 : 
。 Simple_list_item_1 表示 每 行 有 一 个 TextView; 
。 Simple_list_item_2 表示 每 行 有 两 个 TextView; 
。 Simple_list_item_checked 表示 每 行 带 CheckView 的 项 ; 
e Simple_list_item_multiple_choise 表示 每 行 有 一 个 TextView 并 可 以 多 选 ; 
。 Simple_list_item_single_choice 表示 每 行 有 一 个 TextView, 但 只 能 进行 单 选 。 
如 果 以 上 模板 还 无 法 满足 要 求 , 那 只 能 自 定义 模板 。 
自 定义 模板 可 以 根据 自己 的 需要 定义 成 任意 的 格式 ,包括 图 片 .方案 及 其 他 可 显示 的 
视图 ,而且 还 要 考虑 怎样 进行 视图 的 数据 绑 定 。 
ListView 是 一 个 经 常用 到 的 控件 ,ListView 里 面 的 每 个 子 项 Item 可 以 是 一 个 字符 
串 , 也 可 以 是 一 个 组 合 控件 。ListView 要 正常 显示 需要 三 个 元 素 : 
。 用 来 显示 数据 的 ListView 控件 ; 
。 用 来 显示 的 数据 ; 
。 用 来 将 数据 和 ListView 绑 定 的 ListAdapter。 
对 ListView 进行 数据 绑 定 , 必 须 选择 使 用 适配器 。 其 中 最 常 与 ListView 进行 配合 
使 用 的 有 ArrayAdapter、CursorAdapter 及 SimpleAdapter 等 。 
下 面 这 个 例子 ,说 明了 如 何 使 用 ListView 显示 8. 3. 2 节 所 创建 的 ContentProvider 
的 内 容 ( 见 代码 8.17 和 8. 18) 。 
代码 8.17 StudentsContract. java 


public class StudentsContract { 
public static final String AUTHORITY="com.pinecone.technology. 
studentprovider"; 


private StudentsContract () { 
T 


//inner class describing columns and their types 

public static final class Student implements BaseColumns { 
public static final Uri CONTENT URI=Uri.parse("content://" 

+AUTHORITY+"/students"); 

//Expose a content URI for this provider. This URI will be used to 
//access the ContentProvider 
//from within application components using a ContentResolver 
public static final String CONTENT TYPE="vnd.android.cursor.dir/ 
student"; 
public static final String CONTENT_ITEM_TYPE="vnd.android.cursor. 
item/student"; 


Nap 
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代码 8. 18 MainActivity. java 
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8.5 本 章 小 结 


本 章 主要 介绍 了 Android 的 四 大 基础 组 件 之 一 ContentProvider 组 件 。ContentProvider 
是 Android 系统 提供 给 用 户 的 一 个 接口 ,用 于 管理 如 何 访问 应 用 程序 私有 数据 的 存储 库 。 
这 里 的 数据 包括 结构 化 存储 数据 和 非 结 构 化 存储 数据 。 

应 用 程序 使 用 ContentResolver 类 客户 端 对 象 来 访问 ContentProvider 的 数据 ,可 以 


`e 
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称 其 为 访问 提供 器 。ContentResolver 的 方法 提供 了 基本 的 CRUD( 创 建 , 检 索 ,更 新 和 删 
除 ) 数 据 存储 的 功能 。 

应 用 程序 通过 ContentResolver 的 对 象 访问 Provide 时 ,所 使 用 的 方法 会 调用 
ContentProvider 一 个 具体 子 类 对 象 的 相同 名 字 的 方法 。ContentProvider 对 象 通 过 URI 
来 选择 要 访问 Provider 的 表 和 数据 ,Content URI 就 是 ContentProvider 中 数据 的 内 容 统 
一 资源 标识 ,能 够 在 存储 介质 中 唯一 标识 ContentProvider 中 数据 所 在 的 具体 位 置 。 

当 想 用 合适 的 方式 显示 并 操作 一 些 数据 (如 数组 ,链表 、 数 据 库 等 ) 时 ,可 以 使 用 
AdapterView 来 显示 交互 界面 ,这 种 方式 叫 数据 绑 定 。ContentProvider 所 提供 的 数据 可 
以 使 用 数据 绑 定 的 方式 来 显示 。 
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触摸 屏 是 智能 手机 和 平板 电脑 最 重要 的 输入 输出 工具 ,用 户 在 与 系统 或 应 用 程序 交 
互 过 程 中 ,大 多 数 操作 都 是 通过 触摸 屏 来 完成 的 。 触 摸 屏 由 特殊 材料 制 成 ,可 以 获取 屏幕 
上 的 压力 ,并 转换 成 屏幕 坐标 。 这 些 信 息 可 以 被 转换 成 数据 ,并 被 传递 到 软件 里 。 所 以 ， 
应 用 程序 需要 经 常 处 理 用 户 的 触摸 输入 ,包括 一 个 手指 的 触摸 和 多 个 手指 的 触摸 。 


9.1 理解 触摸 事件 


触摸屏 可 以 感知 手指 的 触摸 压力 ,识别 手指 是 抬 起 、 按 下 或 者 是 移动 ;而 且 可 以 将 触 
点 转换 成 屏幕 坐标 ,通过 计算 屏幕 坐标 的 变化 ,可 以 识别 触 点 的 移动 方式 。 当 用 户 和 触摸屏 
幕 时 ,触摸 事件 就 会 产生 。 

1. 手势 

手势 是 指 系统 可 识别 的 ,用 户 在 对 屏幕 显示 对 象 操 作 时 ,手指 在 触摸 屏 上 抬 起 、 按 下 
或 移动 的 方式 。 在 Android 系统 中 支持 的 核心 手势 包括 以 下 几 种 ( 见 图 9. 1) 。 

(1) 触摸 (Touch) : 按 下 , 抬 起 。 和 触发 项 目的 默认 操作 。 

(2) 长 按 (Long Press) : 按 下 ,等待 , 抬 起 。 进 入 选择 模式 ,使 用 户 可 以 选择 视图 中 的 
单个 或 者 多 个 项 目 ,并 选择 上 下 文 操作 栏 的 功能 。 

G) 滑动 (Swipe) : F ,移动 , 抬 起 。 滚 动 内 容 或 者 在 同一 层级 的 不 同 视 图 间 切 换 。 

(4) Ha (Drag): 长 按 ,移动 , 抬 起 。 重 新 排列 视图 中 的 数据 或 者 将 数据 移动 到 容器 
(例如 主屏 幕 上 的 目录 ) 中 。 

(5) 双击 (Double Touch): 快速 两 次 触摸 。 放大 内 容 。 在 文字 选择 中 作为 辅助 
手势 。 

(6) 放大 (Pinch Open): 用 两 个 手指 按 住 , 向 相互 远离 的 方向 移动 , 抬 起 。 放 大 内 容 。 

(7) 缩小 (Pinch Close); 用 两 个 手指 按 住 ,向 相互 接近 的 方向 移动 , 抬 起 。 缩 小 
内 容 。 

2. 触摸 事件 MotionEvent 

在 Android 系统 中 ,触摸 事件 由 MotionEvent 类 来 描述 。 产 生 一 个 触摸 事件 ,系统 就 
会 创建 一 个 MotionEvent 对 象 ,该 对 象 包含 了 触摸 事件 发 生 的 时 间 和 位 置 ,以 及 发 生 触 
摸 事 件 所 在 区 域 的 压力 、 大 小 和 方向 。 在 应 用 中 ,MotionEvent 对 象 会 被 传递 到 某 些 方法 
中 ,其 中 包括 View 类 的 onTouchEvent() 方 法 。 因 为 View 类 是 很 多 控件 的 父 类 ,这 就 意 
味 着 很 多 控件 都 可 以 通过 MotionEvent 与 用 户 进行 交换 。 例 如 ,MapView 控件 可 以 接受 
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DoubleTouch Pinch Open Pinch Close 
图 9.1 手势 种 类 


触摸 事件 ,允许 用 户 水 平移 动 地 图 到 感 兴趣 的 地 方 ;或 者 虚拟 键盘 对 象 接收 触摸 事件 激活 
虚拟 键 ,实现 在 界面 中 输入 文本 。 

从 用 户 手指 触摸 设备 屏幕 开始 ,到 手指 离开 设备 屏幕 结束 ,Android 系统 会 产生 一 系 
列 与 手指 运动 相关 的 触摸 事件 ,每 个 触摸 事件 都 记录 手指 运动 的 信息 , 称 这 些 触摸 事件 为 
一 个 事件 序列 。 实 际 上 ,很 多 触摸 屏 设备 可 以 同时 记录 多 个 手指 的 运动 轨迹 ,这 样 每 个 运 
动 轨迹 都 会 产生 一 个 触摸 事件 序列 。 每 个 序列 是 从 用 户 触摸 屏幕 开始 , 当 用 户 在 屏幕 上 
移动 时 ,这 个 序列 会 持续 添加 ; 当 手 指 从 屏幕 上 抬 起 后 ,这 个 序列 也 就 结束 。 

MotionEvent 类 中 定义 了 动作 常量 表示 触摸 事件 的 动作 类 型 ,主要 包括 ACTION_ 
DOWN.ACTION_UP.ACTION_CANCEL.ACTION_MOVE 等 。 当 用 户 首次 触摸 屏 
幕 时 ,系统 会 将 带 有 ACTION_DOWN 的 触摸 事件 传递 给 相应 的 视图 控件 ; 当 手 指 在 屏 
幕 上 移动 是 ACTION_MOVE:; 当 抬 起 手指 是 ACTION_UP; 而 且 在 手指 抬 起 之 前 系统 可 
能 会 产生 很 多 ACTION _ MOVE 的 触摸 事件 。 所 有 这 些 触 摸 事 件 都 会 产生 相应 的 
MotionEvent 对 象 ,其 中 包含 了 动作 的 种 类 、 触 摸 发 生 的 位 置 、 触 摸 的 压力 、 触 摸 的 面积 、 
动作 发 生 的 时 间 和 初始 ACTION_DOWN 的 时 间 等 属性 。 而 ACTION_OUTSIDE 是 一 
个 特殊 动作 ,是 指 当 手 指 移动 到 在 窗 体 之 外 时 ,系统 仍然 可 以 得 到 这 样 的 触 控 事 件 。 一 般 
来 说 ,一 个 手指 触摸 屏幕 会 触发 一 个 最 简单 的 触摸 事件 序列 首先 应 该 是 ACTION _ 
DOWN ,然后 会 有 多 个 ACTION_MOVE, 最 后 一 个 ACTION_UP 结束 。 
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有 些 触摸 屏 设备 可 以 在 同一 时 间 发 现 多 个 移动 轨迹 , 称 为 多 点 触 控 。Android 系统 
的 MotionEvent 类 也 支持 多 点 触 控 。 其 中 包括 ACTION _ POINTER _ DOWN 和 
ACTION_POINTER_UP 两 个 动作 常量 ,分 别 表示 除 第 一 个 之 外 的 手指 在 屏幕 触摸 时 的 
动作 和 除 第 一 个 之 外 的 手指 从 屏幕 抬 起 时 的 动作 。 

MotionEvent 类 使 用 两 个 属性 来 表示 具体 的 触 点 ,一 个 是 触 点 ID ,一 个 是 触 点 索引 ， 
并 提供 许多 方法 用 来 查询 每 个 触 点 位 置 以 及 其 他 属性 ,如 getX Gnt), getY (int), 
getAxisValue(int) ,getPointerId(int) ,getToolType(int) 等。 这 些 方法 中 大 部 分 接收 触 
点 索引 作为 参数 而 不 是 触 点 ID。getPointerCount() 方 法 可 以 获得 指针 总 数量 ,而 和 触 点 索 
引 的 取 值 范围 是 从 0 开始 ,到 指针 总 数量 减 1 结束 。 当 发 生 多 点 触摸 事件 时 ,每 个 触 点 索 
引 是 会 发 生变 化 的 ,而 触 点 ID 在 触摸 点 移动 过 程 中 不 会 发 生变 化 。getPointerId(int) 方 
法 传人 触 点 索引 可 以 获得 触 点 ID ,而 findPointerIndex(int) 方 法 传人 触 点 ID 可 以 获得 触 
点 索引 。 

当 多 点 触 控 事 件 发 生 时 ,系统 可 能 产生 的 事件 见 表 9. 1 。 




















表 9.1 触 控 事件 
触摸 事件 # g 
MotionEvent. ACTION_DOWN 新 的 触摸 事件 
MotionEvent. ACTION_MOVE 移动 手指 
MotionEvent ACTION_UP 手指 抬 起 
MotionEvent ACTION_CANCEL 删除 事件 
MotionEvent. ACTION_POINTER_DOWN 多 点 按 下 
MotionEvent. ACTION_POINTER_UP 多 点 抬 起 





由 于 应 用 程序 的 开发 ,在 真 机 调试 之 前 都 是 在 模拟 机 上 调试 的 ,在 处 理 多 点 触 控 事件 
时 ,需要 注意 模拟 机 和 真 机 上 触 屏 事件 有 一 些 不 同 。 

A) 屏幕 的 精度 。 

在 模拟 机 上 的 精度 是 整数 ,例如 52 >x 20; 而 在 真 机 上 有 小 数 ,例如 42. 8374X 
25.293747, MotionEvent 的 位 置 由 XX 轴 和 YY 轴 坐 标 组 成 的 ,X 轴 表 示 从 视图 左手 边 到 
触 屏 点 的 距离 ,Y 轴 表 示 从 视图 的 顶端 到 触 屏 点 的 距离 。 

(2) 触摸 事件 中 压力 描述 。 

在 模拟 机 上 的 压力 值 为 0, 而 在 真 机 上 输出 的 压力 值 表示 手指 在 触摸 屏 上 向 下 的 力 
度 。 如 果 使 用 小 拇指 的 指 尖 轻 轻 触摸 , 则 触摸 事件 的 压力 和 大 小 比较 小 ;如 果 用 力 使 用 大 
拇指 , 则 触摸 事件 的 压力 和 大 小 都 是 比较 大 的 。 触 摸 事 件 的 压力 和 大 小 是 在 0~1。 但 
是 ,对 于 不 同 的 设备 来 说 ,没有 一 个 绝对 的 值 用 来 比较 触摸 事件 的 压力 和 尺寸 的 大 小 ;而 
对 于 同一 个 设备 来 说 ,只 能 相对 地 比较 触摸 事件 之 间 的 压力 和 尺寸 大 小 ,不 能 拿 一 个 绝对 
的 值 来 确定 压力 和 尺寸 的 大 小 。 例 如 ,在 某 些 设备 上 这 个 值 从 来 不 超过 0. 8 ,而 某 些 设备 
上 这 个 值 从 来 不 超过 0. 2。 
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(3) 触摸 事件 序列 。 

在 Android 中 使 用 触摸 屏 时 ,如 果 应 用 程序 在 模拟 器 中 运行 , 当 鼠 标 单 击 一 次 模拟 器 
屏 然 后 释放 后 ,会 先 触发 ACTION_DOWN 然后 是 ACTION_UP 共 两 个 触摸 事件 ,只 有 
在 屏幕 上 移动 时 才 会 触发 ACTION_MOVE 的 动作 ;但 在 真 机 中 测试 时 , 单 击 会 首先 产 
Æ ACTION_DOWN 触摸 事件 ,如 果 手 指 不 抬 起 即使 不 移动 也 会 一 直 产 生 ACTION_ 
MOVE 触摸 事件 ,手指 只 有 离开 屏幕 时 才 会 产生 ACTION_UP 和 触摸 事件 。 

当 手 指 触摸 到 设备 的 边界 位 置 时 ,触摸 事件 的 边界 标记 会 被 检测 到 。 而 Android X 
档 上 显示 , 当 触 摸 到 设备 的 边界 ( 顶 、 底 、 左 和 右 ) 时 ,这 个 标记 会 被 设置 。 但 是 有 时 
getEdgeFlags() 方 法 总 是 显示 为 0。 实际 上 ,有 些 硬 件 很 难 检测 到 触摸 在 设备 的 边界 上 ， 
所 以 Android 系统 不 可 能 设置 这 个 参数 。MotionEvent 类 提供 了 setEdgeFlags() 方 法 ， 
目的 是 可 以 自己 来 设置 这 个 值 。 


9.2 事件 传递 机 制 


当 触 摸 事件 发 生 时 ,MotionEvent 对 象 会 作为 参数 被 传递 到 应 用 程序 中 的 相应 方法 
rB, fE Android 系统 中 ,ViewGroup、View、Activity 及 其 子 类 都 提供 了 处 理 触摸 事件 的 
回调 方法 。 触 摸 事 件 与 前 面 所 接触 的 按钮 .编辑 框 \ 菜 单 和 动作 条 等 图 形 控 件 的 事件 有 所 
不 同 。 当 用 户 直 接 针 对 这 些 图 形 控件 进行 键盘 操作 时 ,应 用 程序 直接 回调 对 应 的 注册 监 
听 器 进行 处 理 。 但 当 触 摸 事件 发 生 时 ,会 遇 到 多 种 情况 。 例 如 屏幕 中 包含 一 个 
ViewGroup ,而 这 个 ViewGroup 又 包含 一 个 子 View 时 ,Android 系统 如 何 处 理 触 摸 事件 
呢 ? 到 底 是 ViewGroup 来 处 理 触摸 事件 ,还 是 子 View 来 处 理 触摸 事件 呢 ? 如 果 一 个 视 
图 控件 注册 了 OnClickListener 和 OnLongClickListener 监听 器 ,分 别 实现 了 onClick() 和 
onLongClick() 方 法 , 当 用 户 触摸 到 屏幕 上 的 这 个 视图 控件 时 ,Android 系统 如 何 区 分 ? 应 
当 使 用 onTouchEvent () 方 法 ,还 是 onClick() 方 法 ,或 是 onLongClick() 方 法 来 处 理事 件 呢 ? 

如 果 要 解答 这 些 问题 ,需要 深入 理解 触摸 事件 的 传递 和 消费 机 制 。 在 Android 系统 
中 ,同一 个 触摸 事件 可 以 按 次 序 传递 到 不 同 的 视图 控件 ,所 以 可 以 依次 被 视图 控件 处 理 ， 
如 果 某 视图 控件 完全 响应 而 且 不 再 传递 这 个 触摸 事件 , 则 称 为 消费 了 触摸 事件 。 

真正 理解 了 触摸 事件 的 传递 和 消费 机 制 ,才能 编写 出 正确 响应 界面 操作 的 代码 ,尤其 
当 屏 幕 上 的 不 同 视 图 控件 ,需要 针对 同一 个 界面 触摸 事件 做 出 不 同 响应 的 时 候 。 例 如 ,应 
用 程序 在 桌面 上 设置 了 一 个 控件 , 当 用 户 针 对 控件 做 各 种 操作 时 ,有 时 桌面 本 身 要 对 用 户 
的 操作 做 出 响应 ,有 时 忽略 。 只 有 搞 清楚 事件 触发 和 传递 的 机 制 才 有 可 能 保证 在 界面 布 
局 非常 复杂 的 情况 下 ,UI 控件 仍然 能 正确 响应 用 户 的 操作 。 

在 处 理 触摸 事件 时 ,一 个 用 户 的 操作 可 能 会 被 传递 到 不 同 的 控件 ,或 同一 个 控件 的 不 
同 监 听 方法 内 进行 处 理 。 如 果 任 何 一 个 接收 该 事件 的 方法 在 处 理 完 后 返回 了 true, 则 该 
事件 就 算 处 理 完 成 了 ,其 他 的 视图 或 者 监听 方法 就 不 会 再 有 机 会 处 理 该 事件 了 。 


9.2.1 内 外 层次 之 间 
一 般 来 说 ,用 户 界 面 的 树 形 结构 是 由 多 个 View 和 ViewGroup 形成 的 ,它们 之 间 具 
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有 由 外 向 内 的 包含 关系 ,而 触摸 事件 可 以 在 相 邻 的 层次 之 间 传 递 , 传 递 方向 先 从 外 向 内 ， 
然后 从 内 向 外 。 从 外 向 内 传递 就 是 从 最 外 层 的 根 元素 依 次 递归 向 其 包含 的 子 元 素 传递 ， 
一 直到 最 内 层 子 元 素 ,或 中 间 某 个 元 素 消费 了 触摸 事件 ,结束 了 传递 ;从 内 向 外 就 是 从 最 
内 层 子 元 素 依 次 递归 向 外 层 传 递 ,直到 根 元 素 或 中 间 某 个 元 素 消费 了 触摸 事件 ,结束 了 
传递 。 

1. 处 理 触 摸 事 件 传 递 的 方法 

Android 系统 使 用 下 面 三 个 方法 来 处 理 触 摸 事 件 的 传递 : 

1) public boolean dispatchTouchEvent(MotionEvent ev) 

这 个 方法 是 View、Activity 和 ViewGroup 类 中 的 方法 ,用 来 分 发 触摸 事件 。 可 以 把 这 
个 方法 作为 一 个 控制 器 ,由 其 决定 如 何 处 理 路 由 触摸 事件 。 View 类 中 的 
dispatch TouchEvent () 方 法 判断 是 将 触摸 事件 传递 给 View. OnTouchListener. onTouchEvent () 
或 者 View. onTouchEvent () 方 法 。ViewGroup 类 中 的 dispatchTouchEvent () 方 法 覆盖 了 
View. dispatchTouchEvent() 方 法 ,其 包含 了 更 复杂 的 算法 ,用 来 弄 清 楚 哪个 子 视图 应 该 
得 到 触摸 事件 ,而 且 需 要 调用 子 视图 的 dispatchTouchEvent() 方 法 。 

2) public boolean onlntercept TouchEvent( MotionEvent ev) 

这 个 方法 只 是 ViewGroup 类 中 的 方法 ,用 来 拦截 触摸 事件 。ViewGroup 一 般 都 会 
包含 View, mM H. ViewGroup 和 View 都 包含 onTouchEvent() 方 法 。 如 果 
onInterceptTouchEvent() 返 回 true 时 , 则 执行 此 ViewGroup 中 的 onTouchEvent() 方 
法 ;如 果 onInterceptTouchEvent() 返 回 false 时 ,触摸 事件 将 传递 给 View, H View 的 
dispatchTouchEvent() 方 法 再 来 开始 这 个 事件 的 分 发 。 

3) public boolean onTouchEvent(MotionEvent ev) 

这 个 方法 可 以 用 来 处 理 触摸 事件 。 该 方法 在 View、ViewGroup 以 及 Activity 类 中 
都 有 定义 ,并 且 所 有 的 View 子 类 全 部 重 写 了 该 方法 ,包括 Layouts、Buttons、Lists、 
Surfaces、Clocks 等 ,这 说 明 所 有 的 这 些 组 件 都 可 以 使 用 触摸 事件 进行 交互 ,应 用 程序 可 
以 通过 该 方法 处 理 手机 屏幕 的 触摸 事件 。 

2. 触摸 事件 传递 方法 的 测试 

下 面 一 个 例子 ,可 以 测试 这 种 触摸 事件 的 传递 方法 。 在 一 个 自 定义 的 布局 中 包含 自 
定义 的 TextView 控件 ,并 且 分 别 覆 盖 Activity、 自 定义 布局 和 TextView 中 的 三 个 方法 ， 
方法 的 内 容 主 要 是 日 志 输 出 和 控制 触摸 事件 的 传递 。 

首先 ,创建 一 个 LinearLayout 的 子 类 ,覆盖 上 面 所 列 出 的 处 理 触 摸 事 件 的 三 个 方法 
dispatchTouchEvent()、onInterceptTouchEvent() 和 onTouchEvent(), 处 理 在 这 个 布局 
上 发 生 的 触摸 事件 。 当 在 不 同 的 触摸 事件 发 生 时 ,根据 事件 的 类 型 ,输出 带 有 事件 处 理 方 
法 和 事件 类 型 的 日 志 信 息 ( 见 代码 9. 1)。 

代码 9.1 自 定义 布局 


public class MyLayoutView extends LinearLayout { 
private final String TAG="MyLayoutView"; 


public MyLayoutView (Context context, AttributeSet attrs) { 


`o 
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定义 一 个 Text View 类 的 子 类 作为 用 户 界 面 布局 中 的 输入 框 ,并 覆盖 其 触摸 事件 处 
理 的 方法 dispatchTouchEvent() 和 onTouchEvent() ,实现 当 在 不 同 的 触摸 事件 发 生 时 ， 
根据 事件 的 类 型 ,输出 带 有 事件 处 理 方法 和 事件 类 型 的 日 志 信息 ( 见 代码 9. 2) 。 

代码 9.2 自 定义 输入 框 
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然后 ,定义 用 于 测试 的 Activity 的 布局 文件 ,其 中 定义 触摸 事件 传递 的 层次 关系 ( 见 
代码 9. 3)。 
代码 9.3 XML 布局 文件 
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android:orientation="vertical" 


android:tag="My Layout"> 


<cn.edu.uibe.mcommerce.chapterll.motionEvent.motionEvent.MyTextView 
android:id="@+id/tv" 
android:layout_width="200dip" 
android:layout_height="100dip" 
android:background="#00FF00" 
android:gravity="center" 
android:text="My TextView" 
android:textColor="#0000FF" 
android:textSize="20sp" 
android:textStyle="bold" /> 


</cn.edu.uibe.mcommerce.chapterll.motionEvent.motionEvent.MyLayoutView> 


定义 好 布局 文件 后 ,创建 一 个 Activity, 导 入 所 定义 的 XML 布局 文件 ,运行 应 用 程 
序 , 可 以 显示 出 图 9. 2 的 界面 。 

图 9.2 显示 的 界面 中 ,从 外 到 内 包括 一 个 Activity 
(View) ,一 个 自 定义 Layout(ViewGroup) 和 一 个 自 定义 
的 TextView(View) 。 深 色 部 分 是 自 定义 布局 , 浅 色 部 分 
是 自 定义 的 TextView。 如 果 用 手指 触摸 界面 ,就 会 产生 
一 系列 触摸 事件 。 首 先 产生 的 是 MotionEvent. ACTION 
_DOWN 事件 ,这 是 触摸 事件 系列 的 第 一 个 事件 。 图 9.2 运行 效果 

在 触摸 事件 传递 过 程 中 ,ACTION_DOWN 经 过 的 
界面 元 素 实际 上 都 是 继承 了 View 或 者 ViewGroup 类 , 这 两 个 类 中 都 包含 
dispatchTouchEvent() 方 法 ,但 是 触摸 事件 处 理 的 最 外 层 却 不 是 这 些 界面 元 素 , 而 会 首先 
从 调用 当前 Activity 的 dispatchTouchEvent() 方 法 ,然后 才 将 触摸 事件 传递 给 其 中 的 
View 或 者 ViewGroup 元 素 。 这 样 ,触摸 事件 首先 从 最 外 层 View 或 者 ViewGroup 元 素 
向 内 层 View 或 者 ViewGroup 元 素 传 递 。 

在 触摸 事件 从 外 层 的 界面 元 素 向 内 层 的 界面 元 素 的 传递 过 程 中 ,如 果 事件 传递 到 继 
承 了 ViewGroup 类 的 界面 元 素 , 则 会 调用 ViewGroup 类 的 onInterceptTouchEvent() 方 
法 ,这 个 方法 表示 是 否 拦截 触摸 事件 。 如 果 这 个 方法 返回 true, 表 示 这 个 ViewGroup 拦 
截 了 事件 的 传递 ,触摸 事件 不 会 再 往 下 传递 给 它 的 子 View 元 素 , 而 是 由 这 个 ViewGroup 
元 素 处 理 ,调用 其 onTouchEvent() 方 法 ;如 果 在 传递 的 过 程 中 没有 ViewGroup 拦截 事 
件 , 即 经 过 的 所 有 onInterceptTouchEvent() 方 法 都 返回 false, 那 么 触摸 事件 最 终 会 传递 
至 最 内 层 的 界面 元 素 ,一 般 是 一 个 视图 控件 ,当然 也 可 以 是 一 个 ViewGroup 元 素 ( 其 内 部 
不 包含 任何 元 素 ) 。 

如 果 最 后 事件 传递 到 一 个 View 元 素 , 而 非 ViewGroup 元 素 , 那 么 会 首先 调用 这 个 
View 的 OnTouchListener 的 onTouch() 方 法 或 者 调用 View 的 onTouchEvent() 方 法 ,其 
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默认 返回 true; 如 果 最 后 事件 传递 到 一 个 ViewGroup 元 素 , 会 调用 它 的 onTouchEvent O 
方法 ,其 默认 返回 false, 这 样 就 完成 了 触摸 事件 从 外 向 内 的 传递 。 

在 上 面 示例 中 的 Activity 和 自 定 义 布 局 的 三 种 方法 的 返回 值 都 为 false, 则 触摸 事件 
传递 到 最 内 层 的 自 定义 TextView。 由 于 自 定义 的 TextView 的 onTouchEvent() 方 法 返 
回 值 为 true, 所 以 触摸 事件 被 消费 。 图 9. 3 示意 了 从 外 向 内 传递 触摸 事件 的 路 径 。 
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图 9.3 从 外 向 内 传递 触摸 事件 的 路 径 


下 面 是 这 个 过 程 的 日 志 输出 : 


07- 16 21:43:07.809: D/InterceptTouchActivity (18468): dispatchTouchEvent 
action:ACTION DOWN 

07- 16 21: 43: 07. 814: D/MyLayoutView (18468): dispatchTouchEvent action: 
ACTION_DOWN 

07-16 21:43:07.814: D/MyLayoutView (18468): onInterceptTouchEvent action: 

ACTION_DOWN 

07-16 21:43:07.814: D/MyTextView (18468): dispatchTouchEvent action:ACTION 

_DOWN 

07-16 21:43:07.814: D/MyTextView (18468): onTouchEvent action:ACTION_DOWN 
07- 16 21: 43: 07.834: D/InterceptTouchActivity (18468): dispatchTouchEvent 
action:ACTION_MOVE 

07- 16 21: 43: 07. 834: D/MyLayoutView (18468): dispatchTouchEvent action: 

ACTION MOVE 

07- 16 21:43:07.834: D/MyLayoutView (18468): onInterceptTouchEvent action: 

ACTION_MOVE 

07-16 21:43:07.834: D/MyTextView (18468): dispatchTouchEvent action:ACTION 
MOVE 
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07-16 21:43:07.834: D/MyTextView (18468) : onTouchEvent action:ACTION MOVE 
07- 16 21:43:07.834: D/InterceptTouchActivity (18468): dispatchTouchEvent 
action:ACTION UP 

07- 16 21: 43: 07. 834: D/MyLayoutView (18468): dispatchTouchEvent action: 


ACTION_UP 

07-16 21:43:07.834: D/MyLayoutView (18468): onInterceptTouchEvent action: 

ACTION_UP 

07-16 21:43:07.834: D/MyTextView (18468): dispatchTouchEvent action:ACTION 
UP 


07-16 21:43:07.834: D/MyTextView (18468): onTouchEvent action:ACTION UP 


如 果 上 面 例子 中 自 定 义 TextView 的 onTouchEvent() 方 法 返回 了 false, 则 接 下 来 的 
触摸 事件 , 即 ACTION_DOWN 的 此 事件 系列 的 后 续 触 摸 事件 ,就 不 会 再 传递 到 这 个 
View 或 者 ViewGroup 元 素 , 而 会 在 其 父 元 素 终止 ,并 且 调 用 其 父 元 素 的 onTouchEvent () 
方法 。 

这 就 是 说 ,如 果 最 内 层 界面 元 素 的 onTouchEvent() 方 法 返回 了 false, 则 事件 会 自 内 
向 外 再 次 传递 ,直到 某 个 界面 元 素 onTouchEvent() 方 法 返回 true。 这 时 ,此 事件 系列 的 
后 续 触摸 事件 ,也 会 直接 由 这 个 界面 元 素 的 onTouchEvent() 方 法 来 处 理 。 

如 果 从 内 向 外 的 所 有 View 或 者 ViewGroup 界面 元 素 的 onTouchEvent() 方 法 都 返 
El false, 那 么 ACTION_DOWN 的 此 事件 系列 的 后 续 触 摸 事件 最 后 会 由 Activity 处 理 ， 
即 调用 Activity 的 onTouchEvent() 方 法 ,并 且 最 终结 束 触摸 事件 的 传递 ,这 就 是 从 内 向 
外 的 触摸 事件 的 传递 。 

还 是 使 用 上 面 的 例子 ,只 是 在 代码 9. 2 中 ,将 自 定义 TextView 的 onTouchEvent() 
方法 返回 值 改 为 false, 和 触摸 事件 就 从 内 向 外 传递 触摸 事件 ( 见 图 9. 4 虚线 所 示 ) 。 
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下 面 是 这 个 过 程 的 日 志 输 出 : 


07- 16 22:17:55.110: D/InterceptTouchActivity (19689): dispatchTouchEvent 
action:ACTION DOWN 

07- 16 22: 17: 55. 114: D/MyLayoutView (19689): dispatchTouchEvent action: 
ACTION DOWN 

07- 16 22:17:55.114: D/MyLayoutView (19689): onInterceptTouchEvent action: 
ACTION DOWN 

07-16 22:17:55.114: D/MyTextView (19689): dispatchTouchEvent action:ACTION 

DOWN 


07-16 22:17:55.114: D/MyTextView (19689) : onTouchEvent action:ACTION DOWN 
07-16 22:17:55.114: D/MyLayoutView (19689): onTouchEvent action:ACTION DOWN 
07-16 22:17:55.114: D/InterceptTouchActivity (19689) : onTouchEvent action: 
ACTION_DOWN 

07-16 22:17:55.114: D/InterceptTouchActivity (19689): dispatchTouchEvent 
action:ACTION_UP 

07-16 22:17:55.114: D/InterceptTouchActivity (19689): onTouchEvent action: 
ACTION_UP 


如 上 面 的 示例 一 样 ,如果 改变 三 种 方法 的 返回 值 , 会 有 不 同 的 日 志 输出 ,可 以 尝试 改 
变 其 他 方法 的 返回 值 , 体 会 一 下 触摸 事件 传递 的 原理 。 


9.2.2 同一 层次 之 间 


另 一 种 响应 触摸 事件 的 方式 ,就 是 设置 OnTouchListener 监听 器 。OnTouchListener 
是 用 来 处 理 屏 幕 触摸 事件 的 监听 接口 , 当 在 View 的 范围 内 触摸 按 下 、 抬 起 或 滑动 等 动作 
时 都 会 触发 该 事件 。 需 要 实现 该 接口 的 方法 为 : 


public boolean onTouch (View v,MotionEvent event) 


其 中 ,参数 v 为 事件 源 对 象 ;而 参数 event 为 手机 屏幕 触摸 事件 封装 类 的 对 象 ,其 中 
封装 了 该 事件 的 所 有 信息 ,例如 触摸 的 位 置 、 触 摸 的 类 型 以 及 触摸 的 时 间 等 ,该 对 象 会 在 
用 户 触摸 手机 屏幕 时 被 创建 。 当 这 个 方法 的 返回 值 为 true 时 ,表示 处 理 完 触摸 事件 且 不 
传递 到 其 他 回调 方法 ,否则 返回 false。 

现在 回想 一 下 第 4 章 的 内 容 。 可 能 有 人 会 问 , 如 果 用 户 单 击 界面 会 产生 触摸 事件 吗 ? 
如 果 同 时 为 一 个 控件 注册 了 OnClickListener ( ), OnLongClickListener ( ) 和 
OnTouchListener() ,而且 还 覆盖 了 onTouchEvent() 方 法 ,触摸 事件 的 传递 顺序 又 是 怎 
样 的 ? 

实际 上 , 当 用 户 完成 一 次 单 击 操作 时 ,屏幕 上 的 触摸 传感器 得 到 的 按 下 和 抬 起 信和 号， 
可 以 理解 为 发 生 了 触摸 事件 的 ACTION DOWN 和 ACTION_ UP 操作 。 所 以 ,在 
Android 中 的 单 击 事件 是 和 触摸 事件 相关 的 。 如 果 在 一 个 View 中 覆盖 了 onClick ()、 
onLongClick() 及 onTouchEvent() 方 法 , 则 onTouchEvent() 最 先 捕 捉 到 ACTION _ 
DOWN 事件 ,其 次 才 可 能 触发 onClick() 方 法 或 者 onLongClick() 方 法 ,以 及 后 续 的 触摸 
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事件 。 

根据 触摸 事件 处 理 的 逻辑 ,下 面 对 同 时 作用 在 控件 上 的 监听 器 或 onTouchEvent() Jr 
法 的 三 种 情况 进行 分 析 : 

(1) OnClickListener()、OnLongClickListener() 与 onTouchEvent() 同 时 作用 在 一 个 
控件 上 。 在 实际 操作 中 ,是 否 执行 onClick() 和 onLongClick() 方 法 与 触摸 事件 的 
ACTION_DOWN 和 ACTION_UP 动作 有 关 。 当 一 个 单 击 事件 发 生 时 ,事件 发 生 的 顺序 
为 : ACTION_DOWN -> ACTION_UP —> onClick() 。 

如 果 发 生 了 一 个 长 按 事件 ,就 是 按 下 界面 控件 保持 一 段 时 间 , 然 后 抬 起 ,此 时 事件 发 
生 的 顺序 为 : ACTION_DOWN —> onLongClickO-->ACTION_UP. 

(2) OnTouchListener ( ) , onTouchEvent ( ) 同时 作用 在 一 个 控件 上 。 首 先 执 行 
OnTouchListener. onTouch() 的 方法 ,如 果 返 回 值 为 ture, 则 结束 触摸 事件 的 传递 ;如果 
返回 值 为 false, 则 继续 传递 触摸 事件 到 onTouchEvent( ) 方 法 。 

(3) 第 三 种 情况 为 OnClickListener()、OnLongClickListener()、OnTouchListener() 
同时 作用 在 一 个 控件 上 。 由 于 执行 onLongClick() 方 法 是 由 单独 的 线程 完成 的 ,并 且 在 
ACTION_UP 之 前 ,而 onClick() 的 发 生 是 在 ACTION_UP 后 ,因此 同一 次 用 户 触摸 事件 
就 有 可 能 既 发 生 onLongClick() 又 发 生 onClick() 。 对 于 这 种 情况 ,onLongClick() 方 法 使 
用 返回 值 表示 是 否 消费 了 触摸 事件 。 如 果 onLongClick() 方 法 返回 结果 为 true, 那 么 
onClick 事件 就 没有 机 会 被 触发 了 。 如 果 onLongClick() 方 法 返回 false 时 ,一 次 触摸 事件 
的 基本 时 序 为 : onTouch(ACTION_DOWN)-—— onLongClick()—— onTouch( ACTION_ 
UP)—>OnClick() 。 

可 以 看 到 ,在 ACTION_UP 后 仍然 触发 了 onClick() 方 法 。 


9.3 速率 跟踪 


在 Android 应 用 程序 开发 过 程 中 ,特别 是 游戏 程序 开发 中 ,可 能 需要 获取 触摸 点 移动 
的 速度 。 也 就 是 当 手 指 在 触摸 屏 上 运动 时 ,可 能 希望 知道 其 移动 的 速度 有 多 快 。 
Android 提供 了 一 个 VelocityTracker 帮助 类 ,用 来 处 理 触摸 事件 序列 ,跟踪 手指 运动 的 
速率 。 

当 需 要 跟踪 速率 时 ,首先 使 用 VelocityTracker 的 静态 方法 VelocityTracker. obtain() 获 
得 VelocityTracker 对 象 ,然后 可 以 使 用 VelocityTracker. addMovement (MotionEvent 
event) 方 法 添加 触摸 事件 对 象 。 可 以 在 接收 并 且 处 理 MotionEvent 对 象 的 方法 (例如 
OnTouchListener 的 onTouch() 方 法 或 者 onTouchEvent() 方 法 ) 中 添加 addMovement 
(MotionEvent event), 

下 面 使 用 一 个 简单 的 例子 ,将 触摸 点 移动 的 速度 写 人 日 志 信息 ,在 运行 时 可 以 从 控制 
台 看 到 相应 的 信息 。 具 体 实现 见 代码 9. 4, 其 中 touch_velocity_tracker. xml 布局 文件 中 
可 以 只 简单 设置 一 个 TextView。 
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代码 9.4 使 用 VelocityTracker 进行 速率 跟踪 





如 果 VelocityTracker 中 连续 添加 了 两 个 MotionEvent 对 象 ,那么 就 可 以 计算 这 两 个 
MotionEvent 对 象 之 间 的 数据 变化 , 这些 数据 的 变化 反映 了 手指 的 运动 速率 。 
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VelocityTracker 两 个 方法 getXVelocity() 和 getYVelocity() 分 别 返 回 手指 在 又 和 立方 
向 上 的 速率 。 这 两 个 方法 的 返回 值 表示 单位 时 间 段 在 又 和 了 方向 上 移动 的 像素 。 这 个 
单位 时 间 段 可 以 是 每 毫秒 或 秒 , 也 可 以 是 一 个 设置 的 任意 值 。 

在 使 用 这 两 个 方法 之 前 ,需要 VelocityTracker 类 提供 的 computeCurrentVelocity 
(int unit) 方 法 ,来 设置 跟踪 速率 时 VelocityTracker 所 使 用 的 时 间 单 位 。 例 如 ,如 果 想 得 
到 每 毫秒 的 移动 像素 ,给 参数 unit 赋值 为 1; 如 果 想 得 到 每 秒 的 移动 像素 ,给 参数 unit 赋 
值 为 1000。 如 果 手 指 朝 着 X 方 向 的 右 侧 移动 或 者 Y 方向 的 底部 移动 ,getXVelocity() 和 
getYVelocity() 方 法 的 返回 值 为 正 ;如果 手 指 朝 着 XX 方向 的 左 侧 移动 或 者 Y 方 向 的 顶部 
移动 ,getXVelocity() 和 getYVelocity() 方 法 的 返回 值 为 负 。 如 果 结 束 VelocityTracker 
对 象 的 使 用 ,需要 使 用 recycle() 方 法 。 

值得 注意 的 是 , 当 第 一 个 ACTION_DOWN 触摸 事件 被 加 入 到 VelocityTracker 时 ， 
速率 计算 的 结果 虽然 是 零 ,但 是 还 是 必须 首先 增加 这 个 起 点 ,这 样 后 续 的 ACTION 
MOVE 事件 才 可 以 计算 速率 。 在 ACTION_UP 被 加 入 后 ,速率 的 计算 结果 还 是 会 变 成 
零 。 因 此 ,不 要 在 增加 了 ACTION_UP 触摸 事件 之 后 读 取 X 和 YY 的 速率 。 例 如 , 当 开发 
一 个 游戏 程序 实现 用 户 在 屏幕 上 扔 物体 时 ,应 该 在 增加 最 后 一 个 ACTION_MOVE 事件 
之 后 , 才 使 用 速率 来 计算 物体 的 轨道 。 

另 一 点 就 是 跟踪 速率 很 耗费 资源 。 所 以 应 该 在 使 用 完 之 后 回收 VelocityTracker 对 
象 ,这 样 此 对 象 还 可 以 重新 被 使 用 。Android 系统 可 以 允许 有 多 个 VelocityTracker 对 象 
同时 存在 ,但 是 同样 会 占用 更 多 的 内 存 。 当 开始 跟踪 一 个 新 的 触摸 序列 时 ,也 可 以 使 用 
clear() 方 法 使 VelocityTracker 对 象 回 到 初始 状态 。 


9.4 多 点 触 控 


在 2006 年 的 TED 大 会 上 ,Jeff Han 展示 了 一 种 具有 多 点 触 控 技术 的 电脑 屏幕 。 
Android 也 加 入 了 多 点 触 控 功能 ,目前 市 面 上 只 要 使 用 电容 屏 触 控 原 理 的 手机 均 可 以 支 
持 多 点 触 控 技术 ,可 以 实现 图 片 和 页 面 缩放 .手势 操作 等 更 好 的 用 户 体验 。Android 的 多 
点 触 控 功 能 需要 运行 在 Android 2. 0 版 本 以 上 (实际 上 第 一 个 Android 设备 支持 两 个 手 
指 的 多 点 触 控 ) 。 对 于 这 个 版 本 ,可 以 在 屏幕 上 同时 使 用 三 个 手指 完成 缩放 旋转 或 者 任 
何 使 用 多 点 触 控 想 做 的 事情 。 

多 点 触 控 和 单 点 触 控 的 基本 原理 是 一 致 的 。 当 手指 触摸 屏幕 时 ,MotionEvent 对 象 
被 创建 ,并 且 被 传递 到 前 面 介绍 的 方法 中 。 还 可 以 通过 上 面 介 绍 的 MotionEvent 的 
getAction() .getDownTime() 和 getX() 等 方法 来 获取 触摸 事件 的 数据 。 当 在 屏幕 上 有 多 
个 触 点 时 ,MotionEvent 对 象 必须 包含 所 有 触 点 的 信息 ,但 是 getAction() 方 法 得 到 的 只 
是 一 个 触 点 的 动作 值 ,而 不 是 全 部 的 触 点 。getDownTime() 方 法 表示 第 一 个 手指 按 下 的 
时 间 , 如 果 有 多 个 手指 同时 触摸 屏幕 ,之 后 可 能 有 的 手指 离开 了 屏幕 ,但 是 只 要 屏幕 上 还 
存在 最 后 一 个 触 点 ,这 个 时 间 值 就 一 直 保持 不 变 。 当 使 用 getX() 和 getY0O 〇 方法 获取 触摸 
事件 发 生 的 位 置 ,以 及 使 用 getPressure() 方 法 和 getSize() 方 法 获取 触 点 压力 和 大 小 时 ， 
如 果 传 人 触 点 索引 参数 ,就 可 以 获得 对 应 触 点 的 信息 。 对 于 不 带 参数 的 方法 调用 ,只 能 获 
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得 第 一 个 触 点 的 信息 。 

如 果 希 望 使 用 多 点 触 控 ,首先 要 知道 使 用 getPointerCount() 方 法 获取 当前 屏幕 上 的 
触 点 数量 。 只 要 获得 的 触 点 数量 大 于 1, 就 需要 处 理 触 点 索引 和 和 触 点 ID, MotionEvent 
对 象 中 包含 了 当前 从 索引 为 0 开始 的 触 点 信息 ,一 直到 getPointerCount() 方 法 返回 的 最 
大 索引 值 。 触 点 索引 始终 从 0 开始 ,如 果 有 三 个 触 点 , 则 它们 的 索引 分 别 为 0.1 和 2。 调 
用 类 似 getX() 的 方法 必须 使 用 触 点 索引 作为 参数 才 可 以 获得 指定 的 触 点 信息 。 

触 点 ID 也 是 一 个 整数 ,可 以 表示 哪个 触 点 被 跟踪 。 当 第 一 个 手指 触摸 屏幕 时 , 触 点 
ID 也 是 从 0 开始 的 ,但 是 随 着 手指 从 屏幕 上 的 移 走 或 放下 ,当前 这 个 值 就 有 可 能 不 是 从 0 
开始 。 这 是 由 于 Android 系统 使 用 触 点 ID 作为 跟踪 屏幕 上 不 同 手指 的 运动 , 触 点 ID 可 
以 固定 地 指定 某 个 手指 。 为 了 说 明 这 一 点 ,假设 由 两 个 手指 产生 的 一 对 触摸 序列 ,序列 产 
生 的 过 程 为 : 首先 从 手指 1 触摸 开始 ,然后 是 手指 2 触摸 ;接着 手指 1 移 走 , 然 后 手指 2 
移 走 。 手 指 1 触摸 时 ,会 得 到 触 点 ID 为 0, 手指 2 触摸 时 ,会 得 到 触 点 ID 为 1, 而 它们 的 
触 点 索引 也 相同 。 当 手指 1 移 走 时 ,手指 2 的 ID 仍然 为 1, 而 这 时 手指 2 的 触 点 索引 就 
会 变 成 0, 这 就 是 上 面 说 的 触 点 索引 始终 从 0 开始 。 这 样 就 可 以 在 应 用 程序 中 使 用 触 点 
ID 将 触摸 事件 与 特定 的 手指 以 及 涉及 到 的 其 他 手指 关联 起 来 。 

在 一 个 手势 中 ,可 以 使 用 getPointerId() 方 法 获得 触 点 ID, 用 来 在 后 续 的 触摸 事件 中 
跟踪 手指 。 发 生 一 系列 的 动作 后 ,可 以 使 用 findPointerInder() 方 法 找到 触 点 ID 当前 对 
应 的 触 点 索引 ,然后 使 用 触 点 索引 获取 触摸 事件 的 信息 ( 见 代码 9.5). 

代码 9.5 使 用 getPointerId() 方 法 


private int mActivePointerId; 
public boolean onTouchEvent (MotionEvent event) { 


//Get the pointer ID 
mActivePointerId=event.getPointerId(0); 


//… Many touch events later… 


//Use the pointer ID to find the index of the active pointer 
//and fetch its position 
int pointerIndex=event.findPointerIndex (mActivePointerId); 
//Get the pointer's current position 
float x=event.getX(pointerIndex); 
float y=event.getY(pointerIndex); 

) 


另外 ,可 以 使 用 getActionMarked() 方 法 获得 触摸 事件 的 动作 。 与 getAction() 方 法 
不 同 ,这 个 方法 是 为 多 点 触 控 定义 的 。 这 个 方法 的 返回 结果 经 过 掩 码 处 理 ,去 掉 了 触 点 索 
引 的 信息 。 可 以 使 用 getActionIndex() 方 法 返回 触摸 事件 的 触 点 索引 ( 见 代码 9. 6) 。 


代码 9.6 使 用 getActionMasked() 方 法 





9.5 手势 识别 


手势 也 是 一 组 触摸 事件 的 序列 ,由 基本 触摸 事件 的 动作 组 成 。 手 势 可 以 是 简单 的 触 
摸 事 件 序列 ,例如 单 击 ` 滑 屏 等 ,也 可 以 是 自 定义 更 复杂 的 触摸 事件 序列 。 基 本 的 手势 包 
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括 单 击 \ 长 按 、 滑 动 、 拖 动 、 双 击 、 缩 放 操 作 。 每 种 手势 都 是 用 户 的 一 种 特定 动作 ,触摸 屏 可 
以 识别 这 些 动作 完成 相应 的 功能 。 滑 动 就 是 手指 在 屏幕 上 拖 动 一 个 物体 ,快速 地 朝 一 个 
方向 移动 ,然后 抬 起 。 在 浏览 图 片 的 应 用 中 会 用 到 这 种 手势 。 当 用 户 滑动 触摸 屏 时 ,新 的 
图 片 就 会 显示 。 

Android 提供 了 GestureDetector 类 检测 的 一 些 常见 手势 ,其 中 的 方法 包括 onDown()、 
onLongPress() 和 onFling() 等 。 另 外 ,使 用 ScaleGestureDetector 类 来 实现 缩放 手势 。 


951 发 现 手势 


当初 始 化 GestureDetector 对 象 时 ,需要 传人 一 个 实现 了 OnGestureListener 接口 的 
参数 , 当 一 个 特定 的 手势 被 识别 时 ,就 会 执行 OnGestureListener 中 的 各 种 手势 的 处 理 方 
法 。 为 了 使 GestureDetector 对 象 能 够 接收 和 触摸 事件 ,需要 覆盖 View 或 Activity 的 
onTouchEvent() 方 法 ,并 将 所 有 的 触摸 事件 传递 到 GestureDetector 对 象 中 ( 见 代码 9.7) 。 

代码 9.7 使 用 GestureDetector 类 识别 手势 


public class MainActivity extends Activity implements 
GestureDetector.OnGestureListener, 


GestureDetector.OnDoubleTapListener( 


private static final String DEBUG TAG="Gestures"; 


private GestureDetectorCompat mDetector; 


//Called when the activity is first created. 

@override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity_main); 
//Instantiate the gesture detector with the 
//application context and an implementation of 
//GestureDetector.OnGestureListener 
mDetector=new GestureDetectorCompat (this,this); 
//Set the gesture detector as the double tap 
//listener. 
mDetector .setOnDoubleTapListener (this); 


@override 
public boolean onTouchEvent (MotionEvent event) ( 
this.mDetector.onTouchEvent (event); 


//Be sure to ca11 the superclass implementation 
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QOverride 
// 双 击 ,手指 在 触摸 屏 上 迅速 单 击 第 二 下 时 触发 
public boolean onDoubleTap (MotionEvent event) { 
Log.d(DEBUG_TAG, "onDoubleTap: "+event.toString()); 
return true; 


} 


@override 
// 双 击 , 按 下 跟 抬 起 各 触发 一 次 
public boolean onDoubleTapEvent (MotionEvent event) { 
Log.d(DEBUG TAG, "onDoubleTapEvent: "+event.toString()); 
return true; 


} 


@override 
// 单 击 确认 , 即 很 快 地 按 下 并 抬 起 ,但 并 不 连续 单 击 第 二 下 
Public boolean onSingleTapConfirmed(MotionEvent event) { 
Log.d(DEBUG TAG, "onSingleTapConfirmed: "+event .上 toString ()); 


return true; 


) 


在 代码 9.7 中 ,如 果 OnGestureListener 中 方法 执行 的 结果 为 true, 表 明 已 经 处 理 触 
摸 事 件 ; 如 果 结 果 为 false, 则 触摸 事件 继续 传递 ,直到 成 功 处 理 为 止 。 

如 果 只 想 处 理 部 分 手势 ,可 以 继承 SimpleOnGestureListener。SimpleOnGestureListener 
实现 了 OnGestureListener 接口 的 所 有 方法 ,而 且 返 回 值 都 为 false。 因 此 只 需要 覆盖 那 
些 关心 的 方法 即 可 。 无 论 是 否 使 用 OnGestureListener, 最 好 的 做 法 就 是 实现 onDown() 
方法 ,并 返回 true。 这 是 因为 所 有 的 手势 都 需要 判断 onDown() 方 法 的 返回 值 , 如 果 在 
onDown() 中 返回 false( 这 是 SimpleOnGestureListener 中 的 默认 返回 结果 ) ,系统 认为 忽 
略 剩余 的 手势 动作 ,SimpleOnGestureListener 中 的 其 他 方法 不 会 被 调用 。 


952 ”缩放 手势 处 理 


从 Android 2. 2 开始 引入 了 ScaleGestureDetector 类 ,该 类 可 以 用 来 识别 缩放 手势 。 
缩放 手势 有 两 种 操作 : 一 种 是 两 个 手指 同时 触摸 屏幕 ,向 相互 远离 的 方向 移动 ,然后 同时 
离开 屏幕 ,这 是 放大 操作 ; 另 一 种 是 两 个 手指 同时 触摸 屏幕 ,向 相互 靠近 的 方向 移动 ,然后 
同时 离开 屏幕 ,这 是 缩小 操作 。 

下 面 使 用 例子 来 说 明 如 何 使 用 缩放 手势 ,来 缩放 一 个 图 标 文件 。 首 先 定义 XML 布 
局 文件 ( 见 代 码 9.8). 
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代码 9.8 定义 布局 文件 scale detector_layout. xml 





代码 9. 8 布局 文件 中 使 用 ImageView 控件 定义 一 个 图 片 源 , 而 且 定义 了 一 种 矩阵 缩 
放 的 方式 。 这 个 图 片 的 大 小 是 填充 布局 ,这 样 图 片 不 会 被 ImageView 的 边界 剪 切 。 代 
码 9.9 是 具体 实现 缩放 手势 的 Activity 代码 。 

代码 9.9 实现 缩放 手势 
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mScaleDetector.onTouchEvent (ev); 


return true; 


private class ScaleListener extends 
ScaleGestureDetector.SimpleOnScaleGestureListener { 
@Override 
public boolean onScale (ScaleGestureDetector detector) { 
mScaleFactor * =detector.getScaleFactor (); 


//Make sure we don't get too small or too big 
mScaleFactor=Math.max (0.1f, Math.min (mScaleFactor, 5.0f)); 


Log.v (TAG, "in onScale, scale factor="+mScaleFactor); 


mMatrix.setScale (mScaleFactor, mScaleFactor); 


image.setImageMatrix (mMatrix); 
image.invalidate (); 


return true; 


} 


代码 9.9 在 onCreate() 方 法 中 ,获取 了 ImageView 和 ScaleGestureDetector 对 象 , 覆 
盖 Activity 的 onTouchEvent ( ) 方 法。 在 这 个 方法 中 ,将 所 有 触摸 事件 传递 给 
ScaleGestureDetector 的 onTouchEvent () 方 法 ,并 且 结 果 返 回 true。 这 样 Activity 的 
onTouchEvent() 方 法 可 以 不 断 地 获得 新 的 事件 ,并 把 事件 传递 给 ScaleGestureDetector， 
通过 获得 所 有 的 触摸 事件 ,识别 出 缩放 手势 。 

例子 中 ,在 自 定义 ScaleListener 的 onScale() 方 法 中 实现 图 片 的 缩放 。 实 际 上 ， 
OnScaleGestureListener 监听 器 中 有 onScaleBegin() .onScale() 和 onScaleEnd O 三 个 回 
调 方法 ,分别 表示 手势 开始 .进行 和 结束 三 个 过 程 。 

在 onScale() 方 法 中 传人 ScaleGestureDetector 对 象 , 可 以 得 到 很 多 关于 缩放 操作 的 
信息 。mScaleFactor 是 缩放 因子 ,在 1 的 上 下 区 间 ( 最 小 值 为 0. 1, 最 大 值 为 5. 0) 浮动。 
当 两 个 手指 靠近 时 ,此 值 会 小 于 1; 当 两 个 手指 分 开 时 ,此 值 会 大 于 1。mScaleFactor 的 值 
从 从 1 开始 , 随 着 手指 的 靠近 或 分 开 , 图 片 逐渐 变 小 或 变 小 。 如 果 mScaleFactor 等 于 1, 
图 片 是 正常 的 大 小 。 本 例 还 为 mScaleFactor 设置 了 最 小 值 和 最 大 值 ,防止 图 片 过 小 或 
过 类， 
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9.6 拖 放 处 理 


在 对 触摸 屏 操 作 中 ,将 对 象 拖 忠 穿 过 屏幕 是 常用 的 操作 。 如 果 Android 系统 是 
Android 3. 0 或 以 上 的 版 本 ,可 以 使 用 Android 的 拖 放 框架 ,使 用 拖 放 事件 监听 器 View. 
OnDragListener 来 实现 。 

使 用 Android 的 拖 放 框 架 , 允 许 用 户 通过 一 个 图 形 化 的 拖 放手 势 , 把 数据 从 当前 布局 
中 的 一 个 视图 上 转移 到 另 一 个 视图 上 。 这 个 框架 包含 了 一 个 拖 动 事件 类 , 拖 动 监听 器 和 
一 些 辅 助 的 方法 和 类 。 

虽然 这 个 框架 主要 是 为 了 数据 的 移动 而 设计 的 ,但 是 可 以 将 这 些 移 动 的 数据 提供 给 
其 他 的 UI 操作 使 用 。 例 如 ,可 以 创建 一 个 当 用 户 把 一 个 彩色 图 标 拖 到 另 一 个 彩色 图 标 
上 时 ,将 颜色 混合 起 来 的 应 用 。 


961 拖 放 操作 


当 用 户 执行 一 些 被 当 作 是 开始 拖 动 数据 的 信号 的 手势 时 ,一 个 拖 放 动作 就 开始 了 。 
作为 回应 ,应 用 程序 告诉 系统 拖 动 动作 开始 了 。 系 统 回 调 应 用 程序 ,获取 正在 被 拖 动 图 形 
的 数据 ,创建 一 个 拖 动 图 形 的 暗色 代表 图 形 ,成 为 拖 动 阴 影 。 当 用 户 的 手指 将 拖 动 阴影 移 
动 到 当前 布局 上 时 ,系统 创建 发 送 拖 动 事件 ,并 传递 给 拖 动 事件 监听 器 对 象 , 以 及 与 布局 
中 View 相 联系 的 拖 动 事件 回调 方法 。 一 旦 用 户 释 放 这 个 拖 动 阴影 ,系统 就 结束 拖 动 
操作 。 

Android 应 用 程序 在 处 理 拖 放 操 作 时 ,可 以 通过 实现 View. OnDragListener 接口 , 创 
建 拖 动 事件 监听 器 ;然后 通过 View 类 提供 的 setOnDragListener() 方 法 ,为 View 对 象 设 
置 一 个 拖 动 事件 监听 器 对 象 。 每 个 View 对 象 都 可 以 有 一 个 onDragEvent() 回调 方法 。 

应 用 程序 通过 调用 View. OnDragListener 的 startDrag() 方 法 告诉 系统 开始 一 个 拖 
动 ,也 就 是 告诉 系统 可 以 开始 发 送 拖 动 事件 了 。 一 旦 应 用 程序 调用 startDrag() 方 法 , 剩 
下 的 过 程 就 是 使 用 系统 发 送 给 布局 中 的 视图 对 象 的 事件 。 

1. 拖 放 过 程 

拖 放 过 程 包括 以 下 四 个 基本 步骤 或 状态 

1) 开始 

为 了 响应 用 户 开 始 拖 动 的 手势 ,应 用 程序 通过 调用 startDrag() 方 法 告诉 系统 开始 一 
个 拖 动 动作 。startDrag() 的 参数 提供 被 拖 动 的 数据 ,描述 被 拖 动 数据 的 元 数据 以 及 一 个 
绘制 拖 动 阴 影 的 回调 方法 。 

系统 首先 通过 回调 应 用 程序 去 获得 一 个 拖 动 阴影 ,然后 将 这 个 拖 动 阴影 显示 在 设备 
上 ,接着 系统 发 送 一 个 操作 类 型 为 ACTION_DRAG_STARTED 的 拖 动 事件 ,给 当前 布 
局 中 的 所 有 视图 对 象 的 拖 动 事件 监听 器 。 为 了 继续 接收 拖 动 事 件 ,包括 一 个 可 能 的 拖 动 
事件 , 拖 动 事件 监听 器 必须 返回 true。 

如 果 拖 动 事 件 监听 器 返回 值 为 false, 那 么 在 当前 操作 中 就 接收 不 到 拖 动 事件 ,直到 
系统 发 送 一 个 操作 类 型 为 ACTION_DRAG_ENDED 的 拖 动 事件 。 通 过 发 送 false, 监 听 
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器 告诉 系统 它 对 拖 动 操作 不 感 兴趣 ,并 且 不 想 接收 被 拖 动 的 数据 。 

2) 继续 

用 户 继续 拖 动 。 当 拖 动 阴影 和 视图 对 象 的 边界 框 相交 时 ,系统 会 发 送 一 个 或 多 个 拖 
动 事件 给 视图 对 象 的 拖 动 事件 监听 器 ,当然 该 事件 监听 器 已 经 注册 。 作 为 回应 ,监听 器 可 
以 选择 改变 响应 拖 动 事件 的 视图 对 象 的 外 观 。 例 如 ,如 果 事 件 表 明 阴 影 已 经 进入 了 视图 
的 边界 框 (操作 类 型 为 ACTION_DRAG_ENDED) ,那么 监听 器 就 可 以 高 亮 视图 以 作出 
回应 。 

3) 释放 

用 户 在 可 以 接收 数据 的 视图 的 边界 框 内 释放 拖 动 阴影 。 系 统 发 送 一 个 操作 的 类 型 为 
ACTION_DROP 拖 动 事件 给 视图 对 象 的 监听 器 。 这 个 拖 动 事件 包括 调用 startDrag() 方 
法 传 给 系统 的 数据 。 如 果 接 收 释放 动作 的 代码 执行 成 功 ,那么 这 个 监听 器 会 被 期 望 返回 
true 给 系统 。 

值得 注意 的 是 ,只 有 接收 拖 动 事件 的 视图 已 经 注册 了 监听 器 ,用 户 在 这 个 视图 的 边界 
框 内 释放 这 个 拖 动 阴影 时 , ACTION_DROP 事件 才 会 发 生 。 如 果 用 户 在 其 他 情况 下 释 
放 这 个 拖 动 阴影 ,ACTION_DROP 的 拖 动 事件 就 不 会 被 发 送 。 

4) 终止 

在 用 户 释放 拖 动 阴影 并 且 系统 发 送出 一 个 操作 类 型 为 ACTION_DROP 的 拖 动 事 件 
之 后 ,系统 发 送出 一 个 操作 类 型 为 ACTION_DRAG_ENDED 的 事件 来 表明 这 个 拖 动 操 
作 已 经 结束 了 。 不 管用 户 在 哪里 释放 这 个 拖 动 阴影 ,这 个 步 又 都 会 发 生 。 这 个 事件 会 发 
送 给 每 一 个 被 注册 为 接收 拖 动 事件 的 监听 器 ,无 论 其 是 否 接收 了 拖 动 视图 。 

2. 拖 放 事件 

用 户 界 面 的 视图 对 象 通过 实现 View. OnDragListener 接口 的 拖 动 事件 监听 器 ,或 通 
过 它 自身 的 onDragEvent(DragEvent) 回 调 方法 来 接收 拖 动 事 件 。 当 系统 回调 这 个 方法 
或 监听 器 时 ,会 传递 给 它们 一 个 拖 动 事 件 的 对 象 。 在 Android 系统 中 ,使 用 DragEvent 类 
来 描述 拖 动 事件 。 

在 大 多 数 情况 下 ,可 能 会 想 要 使 用 监听 器 。 因 为 实现 一 个 监听 器 类 ,可 以 在 几 个 不 同 
的 视图 对 象 中 使 用 它 。 当 然 , 也 可 以 将 这 个 监听 器 类 作为 一 个 匿名 内 部 类 去 实现 。 实 现 
后 的 监听 器 需要 在 视图 对 象 上 注册 ,该 对 象 才能 够 接收 监听 到 拖 动 事件 。 注 册 监 听 器 可 
以 通过 调用 视图 的 setOnDragListener() 方 法 来 实现 。 

视图 对 象 可 以 同时 有 一 个 监听 器 和 一 个 回调 方法 。 如 果 在 这 种 情况 下 ,系统 会 首先 
调用 监听 器 。 除 非 监听 器 返回 的 是 false, 否则 系统 不 会 去 调用 回调 方法 。onDragEvent 
(DragEvent) 方 法 和 View. OnDragListener 的 结合 跟 触 屏 事件 的 onTouchEvent O 与 
View. OnTouchListener 的 结合 是 相似 的 。 

当 拖 动 事件 发 生 时 ,系统 创建 一 个 DragEvent 对 象 , 并 传递 给 相应 的 回调 方法 或 监 
听 器 。 这 个 对 象 包括 拖 放 事 件 中 正在 发 生 事件 的 类 型 以 及 其 他 依赖 这 个 事件 类 型 的 数 
据 。 监 听 器 调用 getAction() 方 法 就 可 以 获得 这 个 事件 类 型 ( 见 表 9. 2) 。 


39.2 DragEvent 的 事件 类 型 
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在 应 用 程序 调用 startDrag() 并 获得 一 个 拖 动 阴影 之 后 ,视图 对 象 
的 拖 动 事件 监听 器 就 会 接收 到 这 个 事件 类 型 的 事件 


当 拖 动 阴影 刚刚 进入 视图 的 边界 框 范围 时 ,视图 的 拖 动 事件 监听 
器 就 会 接收 到 这 个 动作 类 型 的 事件 。 这 是 当 拖 动 阴影 进入 视图 
ACTION_DRAG_ENTERED 的 边界 框 范围 时 监听 器 所 接收 到 的 第 一 个 事件 操作 类 型 。 如 果 
监听 器 还 继续 为 拖 动 阴影 进入 视图 边界 框 范围 这 个 动作 接收 拖 
动 事件 ,那么 必须 返回 true 给 系统 


当 拖 动 阴影 还 在 视图 的 边界 框 范围 中 ,视图 的 拖 动 事件 监听 器 就 
ACTION_DRAG_LOCATION 会 在 接收 到 ACTION_DRAG_ENTERED 事件 之 后 接收 到 这 个 操 
作 类 型 的 事件 


当 视 图 的 拖 动 事件 监听 器 接收 到 ACTION_DRAG_ENTERED 事 
件 ,并 且 至 少 接 收 到 一 个 ACTION_DRAG_LOCATION 事件 , 那 
么 在 用 户 把 拖 动 阴影 移 除 视图 的 边界 框 范围 之 后 ,该 监听 器 就 会 
再 接收 到 这 个 操作 类 型 的 事件 








ACTION_DRAG_STARTED 











ACTION_DRAG_EXITED 





当 用 户 在 视图 对 象 上 释放 拖 动 阴 影 时 ,该 视图 对 象 的 拖 动 事件 监 
听 器 就 会 接收 到 这 个 类 型 的 拖 动 事件 。 这 个 操作 类 型 只 会 发 送 
给 在 回应 ACTION_DRAG_STARTED 类 型 的 拖 动 事件 中 返回 
ACTION_DROP true 的 那个 视图 对 象 的 监听 器 。 如 果 用 户 释放 拖 动 阴影 的 那个 视 
图 没有 注册 监听 器 ,或 者 用 户 在 当前 布局 之 外 的 任何 对 象 上 释放 
了 拖 动 阴影 ,那么 这 个 操作 类 型 就 不 会 被 发 送 。 如 果 释 放 动 作 顺 
利 ,监听 器 应 该 返回 true, 否则 应 该 返回 false 





当 系 统 结束 拖 动 动作 时 ,视图 对 象 的 拖 动 事件 监听 器 就 会 接收 到 
这 个 类 型 的 拖 动 事 件 。 这 种 操作 类 型 前 面 不 一 定 有 一 个 
ACTION_DROP 事件 。 如 果 系 统 发 送 一 个 ACTION_DROP, 3Ë 
ACTION_DRAG_ENDED 接收 到 一 个 ACTION_DRAG_ENDED 操作 类 型 ,并 不 意味 着 拖 
动 事件 的 成 功 。 监 听 器 必须 调用 getResult() 方 法 来 获取 在 回应 
ACTION_DROP 事件 中 返回 的 结果 。 如 果 ACTION_DROP 事件 
没有 被 发 送 ,那么 getResult() 就 返回 false 








3. 拖 放 阴影 

在 拖 动 过 程 中 ,系统 会 显示 一 张 用 户 拖 动 的 图 片 。 对 数据 移动 而 言 ,这 张 图 片 代表 着 
那些 正在 被 移动 的 数据 。 对 其 他 操作 而 言 , 这 张 图 片 代 表 着 拖 动 操作 的 某 些 环节 。 这 张 
图 片 就 被 叫做 一 个 拖 动 阴 影 。 

拖 动 阴影 可 以 通过 在 View. DragShadowBuilder 中 定义 的 方法 创建 ,并 调用 应 用 程 
序 定 义 的 View. DragShadowBuilder 里 面 的 回调 方法 去 获取 一 个 拖 动 阴影 。 

View. DragShadowBuilder 类 有 两 个 构造 方法 : 

e View. DragShadowBuilder( View) 。 

此 构造 方法 接收 的 应 用 程序 中 的 任意 一 个 视图 对 象 ,并 将 此 视图 对 象 存储 在 View. 
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DragShadowBuilder 对 象 中 。 因 此 在 回调 过 程 中 ,可 以 直接 把 它 作为 拖 动 阴影 。 构 造 方 
法 不 必 和 用 户 选择 开始 一 个 拖 动 的 视图 对 象 (如 果 有 的 话 ) 相 关联 。 

如 果 使 用 这 个 构造 方法 ,不 必 去 继承 View. DragShadowBuilder 类 或 覆盖 它 的 方法 。 
默认 情况 下 ,会 得 到 一 个 与 作为 参数 传递 的 那个 视图 有 相同 外 表 的 拖 动 阴影 ,并 且 该 拖 动 
阴影 会 居中 位 于 用 户 接触 的 屏幕 上 。 

e View. DragShadowBuilder() 。 

如 果 使 用 该 构造 方法 ,在 View. DragShadowBuilder 对 象 中 没有 一 个 视图 对 象 是 有 
效 的 (这 个 字段 被 设置 为 null)。 如 果 使 用 该 构造 方法 , 不必 继承 View. 
DragShadowBuilder 类 或 覆盖 它 的 方法 ,可 以 得 到 一 个 不 可 见 的 拖 动 阴影 。 系 统 不 会 给 
出 一 个 错误 。 

View. DragShadowBuilder 类 有 两 个 方法 : 

* onProvideShadow Metrics( )。 

系统 在 调用 了 android. view. View. DragShadowBuilder 的 startDrag() 方 法 之 后 , 立 
刻 回调 用 该 方法 。 用 该 方法 给 系统 发 送 拖 动 阴影 的 规模 和 接触 点 。 该 方法 有 两 个 参数 ， 
其 中 dimensions 表示 一 个 Point 对 象 , 指 拖 动 阴影 的 宽 为 x, 高 为 y; 另 一 个 参数 touch_ 
point 表示 一 个 Point 对 象 , 指 拖 动 过 程 中 ,在 用 户 手 指 之 下 的 拖 动 阴影 的 位 置 ,X 轴 坐 标 
为 x,Y 轴 坐 标 为 y。 

* onDrawShadow() 。 

在 调用 了 onProvideShadowMetrics() 方 法 之 后 ,系统 立刻 调用 onDrawShadow() 这 
个 方法 来 获取 拖 动 阴影 。 这 个 方法 只 有 一 个 参数 ,一 个 Canvas 对 象 ,该 对 象 是 系统 利用 
提供 给 onProvideShadowMetrics() 方 法 里 面 的 参数 构造 出 来 的 。 利 用 它 可 以 在 提供 给 
的 Canvas 对 象 中 绘制 拖 动 阴影 。 


962 设计 拖 动 操作 


本 节 说 明 如 何 开始 一 个 拖 动 , 如 何在 拖 动 过 程 中 回应 事件 ,如 何 回应 一 个 拖 动 事件 以 
及 如 何 结束 一 个 拖 放 操作 。 

1. 开始 拖 动 

用 户 用 一 个 拖 动 的 手势 开始 一 个 拖 动 ,通常 是 一 个 在 视图 对 象 上 的 长 按 动 作 。 作 为 
回应 ,需要 做 下 面 两 件 事 情 。 

(1) 为 要 移动 的 数据 创建 一 个 ClipData 和 ClipData. Item 对 象 。 

当 用 户 在 一 个 视图 上 有 一 个 长 按 动作 时 ,需要 创建 一 个 ClipData 和 ClipData. Item 
对 象 ,用 于 存储 在 ClipDescription 对 象 中 的 元 数据 。 因 为 一 个 拖 放 动 作 不 能 表示 数据 的 
移动 ,可 使 用 null 来 代替 一 个 实际 的 数据 。 

例如 ,下 面 一 个 例子 说 明了 当 在 ImageView 上 有 一 个 长 按 动 作 事件 时 ,如 何 创 建 一 
个 ClipData 对 象 ,来 包含 这 个 ImageView 的 标志 或 标签 ( 见 代 码 9. 10) 。 以 下 就 是 这 些 
片段 ,第 二 个 片段 说 明了 如 何 重 写 View. DragShadowBuilder 类 中 的 方法 。 
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代码 9.10 创建 ClipData 对 象 
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(2) 创建 拖 动 阴影 。 

创建 一 个 View. DragShadowBuilder ñj + 类 MyDragShadowBuilder， 覆 盖 
onDrawShadow() 方 法 和 onProvideShadowMetrics() 方 法 ,为 拖 动 一 个 Text View 创建 一 
个 小 的 灰色 和 矩形 框 拖 动 阴影 ( 见 代码 9. 11) 。 

代码 9.11 覆盖 View. DragShadowBuilder 的 方法 
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其 中 onProvideShadowMetrics() 方 法 中 的 代码 实现 了 回调 方法 ,把 拖 动 阴影 的 位 置 
和 触摸 点 传递 给 系统 ; onDrawShadow() 方 法 的 代码 实现 了 回调 方法 ,基于 系统 ,根据 
onProvideShadowMetrics() 方 法 中 传递 的 位 置 , 在 所 构建 的 画布 上 画 拖 动 阴 影 。 

继承 View. DragShadowBuilder 和 覆盖 其 方法 的 过 程 并 不 是 必需 的 ,构造 方法 
View. DragShadowBuilder( View) 会 创建 一 个 默认 的 拖 动 阴影 ,这 个 拖 动 阴影 与 传递 给 它 
的 View 参数 一 样 大 ,并 且 位 于 以 接触 点 为 中 心 的 位 置 。 

2. 响应 拖 动 开始 事件 

在 拖 动 过 程 中 ,系统 将 拖 动 事件 传递 给 当前 布局 中 的 视图 对 象 的 拖 动 事件 监听 器 。 
监听 器 应 该 调用 getAction() 方 法 获取 操作 类 型 。 在 一 个 拖 动 开始 时 ,该 方法 返回 
ACTION_DRAG_STARTED。 

当 ACTION_DRAG_STARTED 事件 发 生 时 ,监听 器 需要 进行 下 面 的 处 理 : 

(1) 调用 getClipDescription() 方 法 获取 ClipDescription 。 

使 用 在 ClipDescription 中 的 MIME 类 型 的 方法 查看 监听 器 是 否 接收 被 拖 动 的 数据 。 
如 果 拖 放 操 作 没 有 数据 移动 ,这 个 步骤 就 不 是 必需 的 。 

(2) 如 果 监 听 器 可 以 接收 一 个 拖 动 事件 , 它 必 须 返 回 trues 

所 谓 监听 器 可 以 接收 一 个 拖 动 事 件 , 即 这 个 监听 器 可 以 对 拖 动 事件 进行 处 理 。 设 置 
返回 值 为 true, 告 诉 系 统 继续 发 送 拖 动 事件 给 监听 器 。 如 果 监 听 器 不 接收 一 个 拖 动 ,就 会 
返回 false, 系 统 就 会 停止 发 送 拖 动 事件 ,直到 ACTION_DRAG_ENDED 事件 发 生 。 

对 于 ACTION_DRAG_STARTED 事件 ,有 一 些 拖 动 事件 的 方法 是 无 效 的 ,例如 
getClipData() .getX() getY() 和 getResult() 。 

3. 在 拖 动 过 程 中 处 理事 件 

在 拖 动 过 程 中 , 当 监 听 器 对 ACTION_DRAG_STARTED 拖 动 事件 的 返回 值 为 true 
时 ,监听 器 继续 接收 后 续 的 拖 动 事件 。 监 听 器 在 拖 动 过 程 中 接收 到 的 拖 动 事件 类 型 取决 
于 拖 放 阴影 的 位 置 以 及 监听 器 视图 的 可 见 性 。 

在 拖 动 过 程 中 ,getAction() 返 回 的 事件 类 型 包括 三 个 : 

1) CTION_DRAG_ENTERED 

当 接 触 点 , 即 屏 幕 上 位 于 用 户 手 指 下 的 点 ,进入 监听 器 的 视图 的 边界 框 范围 内 时 , 监 
听 器 会 接收 到 该 事件 。 

2) ACTION_DRAG_LOCATION 

一 旦 监听 器 接收 到 ACTION_DRAG_LOCATION 事件 ,在 它 接收 到 ACTION _ 
DRAG_EXITED 事件 之 前 ,接触 点 每 移动 一 次 , 它 都 会 接收 到 一 个 新 的 ACTION 
DRAG_LOCATION 事件 。 方 法 getX() 和 getY() 会 返回 接触 点 的 X 轴 和 站 轴 的 坐标 。 

3) ACTION_DRAG_EXITED 

在 拖 动 阴影 不 再 位 于 监听 器 视图 的 边界 框 范围 之 内 时 ,这 个 事件 会 被 发 送 给 以 前 接 
收 到 ACTION_DRAG_ENTERED 事件 的 监听 器 。 

当 这 些 事件 发 生 时 ,监听 器 可 以 不 对 任意 一 个 事件 做 出 反应 。 如 果 监 听 器 返回 一 个 
值 给 系统 , 它 也 会 被 忽略 掉 。 
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4. 响应 释放 动作 

当 用 户 在 某 个 视图 上 释放 拖 动 阴影 时 ,该 视图 会 预先 报告 是 否 可 以 接收 被 拖 动 的 内 
容 , 系 统 会 将 拖 动 事件 分 发 给 具有 ACTION_DROP 操作 类 型 的 视图 。 监 听 器 在 事件 处 
理 时 ,需要 做 两 件 事 。 

一 是 调用 getClipData() 方 法 获取 最 初 在 startDrag() 方 法 中 应 用 的 ClipData 对 象 ， 
并 存储 。 如 果 拖 放 操 作 没 有 数据 的 移动 ,就 不 必 进 行 该 操作 。 

二 是 ,如 果 释 放 动 作 已 顺利 完成 ,监听 器 应 返回 true; 如 果 没 有 完成 , 则 返回 false, 
这 个 被 返回 的 值 成 为 ACTION_DRAG_ENDED 事件 中 getResult() 方 法 的 返回 值 。 

需要 注意 的 是 ,如 果 系 统 没有 发 送出 ACTION_DROP 事件 ,那么 ACTION_DRAG_ 
ENDED 事件 中 getResultQ 〇 方法 的 返回 值 就 为 false, 

对 于 ACTION_DROP 事件 来 说 ,在 释放 动作 的 瞬间 ,getX() 和 getY() 方 法 使 用 接收 
释放 动作 的 视图 上 的 坐标 系统 ,返回 拖 动 点 的 X 轴 和 YY 轴 的 坐标 。 

系统 允许 用 户 在 监听 器 不 接收 拖 动 事件 的 视图 上 释放 拖 动 阴影 ,允许 用 户 在 应 用 程 
序 UI 的 空 区 域 或 者 应 用 程序 之 外 的 区 域 释放 拖 动 阴影 。 

5. 回应 一 个 拖 动 的 结束 

用 户 释 放 了 拖 动 阴影 后 ,系统 会 立即 给 应 用 程序 中 所 有 的 拖 动 事件 监听 器 发 送 
ACTION_DRAG_ENDED 类 型 的 拖 动 事件 ,表明 拖 动 动作 结束 。 

当 ACTION_DRAG_ENDED 事件 发 生 时 ,监听 器 需要 进行 如 下 处 理 : 如 果 监 听 器 
在 操作 期 间 改 变 了 View 对 象 的 外 观 , 应 该 把 View 对 象 重 置 为 默认 的 外 观 , 监 听 器 向 系 
统 返回 true。 监 听 器 也 可 以 调用 getResult() 方 法 来 查找 更 多 的 相关 操作 。 如 果 在 响应 
ACTION_DROP 类 型 的 事件 中 监听 器 返回 了 true, 那 么 getResult() 方 法 也 会 返回 true, 
在 其 他 的 情况 中 ,getResult() 方 法 会 返回 false, 包 括 系 统 没有 发 送 ACTION_DROP 事件 
的 情况 。 
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9.6.2 节 介 绍 了 如 何在 拖 放 操作 的 各 个 阶段 对 事件 进行 处 理 , 下 面 使 用 一 个 简单 的 
例子 来 说 明 如 何 实现 拖 放 操作 。 

实现 拖 放 操 作 的 步骤 共有 六 步 ,包括 创建 应 用 程序 可 以 根据 实际 的 情况 删 减 步骤 。 

1. 定义 XML 绘制 图 片 

在 res 的 drawable 目录 下 ,创建 shape. xml 文件, 作为 正常 的 背景 设置 ( 见 代 码 9. 12)。 

代码 9.12 shape. xml 


<?xml version="1.0" encoding="UTF-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 


<stroke 
android:width="2dp" 
android:color="#FFFFFFFF" /> 


SoB “触摸 事件 处 理 \® 





XML 文件 中 的 二 shape 二 元 素 用 于 定义 形状 。 其 子 元 素 二 stroke 二 定义 二 shape 二 中 
线 的 属性 。 子 元 素 <<gradient 之 定义 该 形状 里 面 为 渐变 色 填 充 ,startColor 为 起 始 颜色 ， 
endColor 为 结束 颜色 ,angle 表示 方向 角度 。 子 元 素 二 corners 过 为 shape 创建 圆 角 。 只 
有 当 形 状 为 矩形 时 才能 使 用 。 

另外 还 有 子 元 素 一 padding 之 用 于 填充 应 用 的 视图 对 象 (而 不 是 形状 ), 子 元 素 一 size> 
用 于 定义 shape 的 尺寸 , 子 元 素 <<solid 之 用 于 定义 填充 颜色 。 各 子 元 素 分 别 具 有 自己 的 
属性 ,可 以 根据 设计 来 设 定 。 

在 res 的 drawable 目录 下 ,创建 shape_droptarget. xml 文件 ,作为 当 被 拖 动 对 象 进入 
到 目标 对 象 的 范围 内 后 目标 对 象 的 背景 ( 见 代码 9. 13)。 

代码 9. 13 shape droptarget. xml 
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2. 定义 布局 等 资源 文件 

定义 Activity 显示 的 用 户 界面 main. xml 布局 文件 ,界面 使 用 网 格 布局 ,每 个 网 格 中 
使 用 前 面 定义 的 shape 形状 作为 背景 ,放置 一 个 图 片 ( 见 代码 9. 14) 。 

代码 9.14 布局 文件 
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3. 创建 或 打开 Activity, 获 取 定 义 的 视图 对 象 
创建 DragActivity 作为 主 界面 ,导入 布局 文件 main. xml( 见 代码 9. 15) 。 
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代码 9.15 # Activity 


public class DragActivity extends Activity { 
/xx Called when the activity is first created. * / 


@override 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


) 


4. 定义 或 实现 TouchListener 

在 DragActivity 中 自 定义 一 个 OnTouchListener 的 监听 器 MyTouchListener, 当 接 
收 到 ACTION_DOWN 事件 时 ,创建 一 个 ClipData 对 象 ,使 用 View. DragShadowBuilder 
给 当前 所 触摸 的 对 象 创建 一 个 拖 动 阴影 ,设置 开始 拖 动 操作 ( 见 代 码 9. 16) 。 

代码 9.16 EE X OnTouchListener 


private final class MyTouchListener implements OnTouchListener { 
public boolean onTouch (View view, MotionEvent motionEvent) { 
if (motionEvent.getAction()==MotionEvent.ACTION DOWN) { 
ClipData data=ClipData.newPlainText("", ""); 
DragShadowBuilder shadowBuilder=new View.DragShadowBuilder (view); 
view.startDrag (data, shadowBuilder, view, 0); 
view.setVisibility (View.INVISIBLE); 
return true; 
} else { 
return false; 


} 


在 这 里 也 可 以 使 用 自 定义 OnLongClickListener 来 设置 开始 拖 动 操作 ,在 其 
onLongClick() 方 法 中 创建 ClipDate 对 象 、 创 建 拖 动 阴影 ,以 及 进行 其 他 的 相关 初始 
设置 。 

5. 定义 或 实现 DragListener 

在 DragActivity 中 自 定义 一 个 OnDragListener 的 监听 器 MyDragListener, 定义 在 
拖 动 操作 时 ,各 事件 发 生 时 视图 对 象 的 工作 ( 见 代码 9. 17)。 当 ACTION_DRAG _ 
STARTED 发 生 时 ,因为 前 面 在 onTouch() 代 码 中 已 经 做 了 拖 动 开始 操作 时 的 一 些 处 
理 ,这 里 就 不 再 做 任何 处 理 ; 当 被 拖 动 的 对 象 进 入 本 视图 对 象 的 ACTION _DRAG _ 
ENTERED 事件 发 生 时 ,将 背景 改变 为 shape_droptarget. xml 所 定义 的 图 片 ; 当 拖 动 释 
放 的 ACTION_DROP 事件 发 生 时 ,将 原来 的 拖 动 对 象 删除 ,加 入 到 所 拖 动 到 的 位 置 ; 当 
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拖 动 操作 结束 的 ACTION_DRAG_ENDED 和 ACTION_DRAG_EXITED 事件 发 生 时 ， 
将 背景 改 回 shape. xml 定义 的 正常 背景 。 
代码 9.17 自 定义 OnDragListener 





6. 将 监听 器 注册 到 视图 对 象 

在 DragActivity 中 ,使 用 findViewById() 方 法 获取 布局 文件 中 定义 的 图 片 对 象 ,并 
通过 视图 对 象 的 setOnTouchListener() 和 setOnDragListener() 方 法 ,将 前 面 所 定义 的 监 
听 器 对 象 注册 到 视图 对 象 上 ,完成 整个 程序 的 编写 ( 见 代码 9. 18) 。 
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代码 9. 18 DragActivity. java 
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9.7 本 章 小 结 


本 章 主要 介绍 了 Android 系统 对 于 触摸 屏 的 操作 和 处 理 。 

Android 系统 中 把 用 户 对 触摸屏 的 操作 定义 成 不 同 的 手势 。 手 势 是 指 系 统 可 识别 
的 ,用 户 在 对 屏幕 显示 对 象 操 作 时 ,手指 在 触摸 屏 上 抬 起 、 按 下 或 是 移动 的 方式 。 在 
Android 系统 中 支持 的 核心 手势 包括 触摸 (Touch) .长 按 (Long Press) 滑动 (Swipe) Hi 
电 (Drag)、 双击 (Double Touch) 放大 (Pinch Open) 和 缩小 (Pinch Close). 

在 Android 系统 中 ,触摸 事件 由 MotionEvent 类 来 描述 。 产 生 一 个 触摸 事件 ,系统 就 
会 创建 一 个 MotionEvent 对 象 。 从 用 户 手指 触摸 设备 屏幕 开始 ,到 手指 离开 设备 屏幕 结 
IK, Android 系统 会 产生 一 系列 与 手指 运动 相关 的 触摸 事件 ,每 个 触摸 事件 都 记录 手指 运 
动 的 信息 , 称 这 些 触 摸 事件 为 一 个 事件 序列 。 每 一 个 手势 都 是 一 个 事件 序列 。 
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触摸 事件 的 处 理 遵循 触摸 事件 的 传递 和 消费 机 制 。 触 摸 事件 在 用 户 界 面 的 View 和 
ViewGroup 的 相 邻 层次 之 间 传 递 ,传递 方向 先 从 外 向 内 ,然后 从 内 向 外 。 从 外 向 内 传递 
就 是 从 最 外 层 的 根 元 素 依次 递归 向 其 包含 的 子 元 素 传递 ,一 直到 最 内 层 子 元 素 ,或 中 间 某 
个 元 素 消费 了 触摸 事件 ,结束 了 传递 ;从 内 向 外 就 是 从 最 内 层 子 元 素 依次 递归 向 外 层 传 
递 , 直 到 根 元 素 或 中 间 某 个 元 素 消费 了 触摸 事件 ,结束 了 传递 。 

对 于 触摸 事件 的 处 理 包括 速率 跟踪 、 多 点 触 控 、 手 势 识别 和 拖 放 处 理 。 事 件 处 理 遵循 
触摸 事件 的 传递 和 消费 机 制 ,具体 实现 可 以 采用 事件 监听 的 方式 ,也 可 以 采用 回调 方法 的 
方式 处 理 。 


定位 服务 与 Google 地 图 


10.1 定位 服务 


Android 通过 android. location 包 中 的 类 为 应 用 程序 提供 定位 服务 。 定 位 框架 中 的 
核心 组 件 就 是 LocationManager 系统 服务 ,其 提供 了 支撑 底层 设备 的 定位 API。 与 其 他 
系统 服务 一 样 ,并 不 是 直接 实例 化 一 个 LocationManager 对 象 ,而 是 通过 调用 Context 类 
的 getSystemService (Context. LOCATION _SERVICE ) 方 法 来 获得 一 个 LocationManager 
对 象 。 这 个 方法 会 返回 一 个 新 的 LocationManager 对 象 。 

应 用 程序 获取 一 个 LocationManager 对 象 后 ,就 可 以 进行 定位 服务 的 各 种 操作 ， 
例如 : 

° 查询 所 有 定位 提供 者 列表 ,获得 最 新 的 用 户 位 置信 息 。 

。 周期 性 地 注册 ,更 新 或 注销 用 户 当前 位 置 。 

。 如 果 设 备 进 入 到 一 个 给 定 经 度 和 纬度 邻近 范围 时 (指定 一 个 半径 ) 时 ,注册 或 注销 

一 个 需要 启动 的 Intent。 

使 用 Google 地 图 的 Android API, 可 以 使 用 Google 地 图 数据 ,将 地 图 功能 集成 到 应 
用 中 。API 自动 处 理 对 Google 地 图 服务 器 的 访问 、 数 据 下 载 、 地 图 显示 和 在 地 图 上 触 控 
手势 。 


10.11 获取 位 置信 息 


Android 设 备 获 取 位 置 可 以 使 用 GPS 和 Android 网 络 位 置 提供 器 (Android 
Network Location Provider, NLP)。 尽 管 GPS 定位 更 精确 ,但 它 只 能 在 户外 使 用 、 耗 电 
严重 ,并 且 其 返回 用 户 位 置 的 速度 远 不 能 满足 用 户 需 求 。 网 络 位 置 提供 器 通过 基站 和 
Wi-Fi 信号 来 获取 位 置信 息 ,并 且 室 内 外 均 可 使 用 ,其 速度 更 快 、 耗 电 更 少 。 为 了 获取 用 
户 位 置信 息 , 可 以 同时 使 用 GPS 和 Android 网 络 位 置 提供 器 ,也 可 以 二 者 任 选 其 一 。 

1. 获取 位 置信 息 时 要 解决 的 问题 

那么 哪些 因素 决定 了 定位 呢 ? 获得 用 户 信 息 是 一 个 复杂 的 过 程 , 有 时 候 会 发 现 获 取 
的 位 置信 息 是 错误 的 或 者 精度 不 高 ,原因 有 以 下 几 种 : 

1) 多 种 位 置 源 

GPS, Cell-ID 和 Wi-Fi 都 可 以 提供 用 户 位 置信 息 ,每 种 源 的 精度 是 不 同 的 ,但 是 决定 
使 用 哪个 源 ,需要 权衡 精度 .速度 和 电池 的 容量 。 
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2) 用 户 的 移动 

当 用 户 移动 时 ,因为 用 户 位 置 的 改变 ,必须 经 常 定期 获取 用 户 位 置 ,所 以 当 用 户 在 移 
动 时 ,如 果 获 取信 息 的 频次 越 高 , 则 用 户 位 置信 息 越 精确 ,但 是 高 频次 也 会 影响 设备 的 运 
行 效 率 和 电量 。 

3) 变化 的 精度 

从 每 个 位 置 源 获得 的 位 置 估算 在 精度 方面 也 是 不 一 致 的 。 例 如 ,从 一 个 位 置 上 ,10s 
前 获得 的 位 置 或 许 比 从 相同 的 或 者 不 同 的 源 上 获取 的 最 新 位 置 精度 更 高 。 

2. 实现 定位 功能 的 重要 类 

在 使 用 位 置 服务 开发 应 用 时 ,上 面 这 些 因素 都 需要 考虑 。 但 首先 需要 知道 怎样 获取 
位 置信 息 。 以 下 是 android. location 包 中 几 个 关于 定位 功能 的 比较 重要 的 类 : 

1) Location Manager 

该 类 提供 访问 系统 定位 服务 。 定 位 服务 可 以 为 应 用 程序 提供 周期 性 的 设备 的 地 理 位 
置 更 新 信息 ,或 当 设 备 进入 某 个 地 理 范围 时 ,发 送 应 用 程序 说 明 的 Intent, 

2) LocationProvider 

它 是 一 个 抽象 类 ,是 不 同 定位 提供 者 的 父 类 ,提供 当前 位 置信 息 ,并 存储 在 Location 类 
dB, Android 设备 有 一 些 可 用 的 LocationProvider, 表 10. 1 列 出 了 主要 的 LocationProvider。 


表 10.1 LocationProvider 














LocationProvider Ho g 
network 使 用 移动 网 络 或 Wi-Fi 来 确定 最 佳 位 置 ,在 室内 精度 比 GPS 高 
gps 使 用 GPS 接收 器 来 确定 最 佳 位 置 ,通常 比 网 络 精度 更 高 
passive 允许 参与 其 他 组 件 位 置 更 新 以 节省 能 源 


3) LocationListener 

该 类 提供 定位 信息 发 生 改 变 时 的 回调 功能 。 必 须 事先 在 定位 管理 器 中 注册 监听 器 
对 象 。 

4) Criteria 

该 类 使 得 应 用 能 够 通过 在 LocationProvider 中 设置 的 属性 来 选择 合适 的 定位 提 
供 者 。 

3. 请 求 位 置 更 新 信息 

在 Android 中 ,可 以 通过 回调 的 方法 得 到 用 户 位 置 。 使 用 LocationManager 类 ,向 其 
requestLocationUpdates() 方 法 传人 一 个 LocationListener 对 象 ,就 可 以 获得 位 置 更 新 。 
在 LocationListener 中 ,必须 要 实现 响应 的 几 个 回调 方法 ,以 便当 用 户 位 置信 息 和 服务 状 
态 变 化 时 LocationManager 调用 。 

代码 10. 1 使 用 一 个 简单 的 例子 ,说 明了 如 何 定义 一 个 LocationListener ,并且 请 求 位 
置 更 新 。 
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代码 10.1 位 置 更 新 信息 获取 


//Acquire a reference to the system Location Manager 
LocationManager locationManager= (LocationManager) this. getSystemService 
(Context .LOCATION SERVICE); 


//Define a listener that responds to location updates 
LocationListener locationListener=new LocationListener() ( 
public void onLocationChanged (Location location) { 
//Called when a new location is found by the network location provider. 
makeUseOfNewLocation (location); 
1 


public void onStatusChanged(String provider, int status, Bundle extras) () 
public void onProviderEnabled(String provider) () 


public void onProviderDisabled(String provider) () 
); 


//Register the listener with the Location Manager to receive location updates 
locationManager. requestLocationUpdates (LocationManager. NETWORK _ PROVIDER, 0, 


0, locationListener); 


requestLocationUpdates() 方 法 的 第 一 个 参数 是 位 置 服务 的 类 型 ,也 就 是 程序 通过 什 
么 来 获取 用 户 的 位 置信 息 ;第 二 个 参数 是 两 次 位 置 提醒 之 间 的 最 小 时 间 间 隔 ; 第 三 个 参数 
是 两 次 位 置 提醒 之 间 最 小 距离 间隔 (第 二 三 两 个 参数 都 为 0 表示 尽 可 能 频繁 地 请 求 位 置 
信息 ); 第 四 个 参数 为 LocationListener。 例 如 每 隔 30s 收集 一 次 GPS 信息 ,可 以 用 下 面 
的 代码 实现 : 


locationManager.requestLocationUpdates (LocationManager .GPS PROVIDER,30* 
1000, 0, myListenGPS); 


代码 10. 1 中 ,选择 的 位 置 服务 类 型 为 NETWORK_PROVIDER ,而 Android 系统 提 
供 两 种 位 置 服务 类 型 ,其 中 包括 : LocationManager. GPS_PROVIDER 和 LocationManager. 
NETWORK_PROVIDER 。 

应 用 程序 如 果 要 使 用 这 两 种 方式 的 定位 服务 ,需要 通过 系统 设置 , 见 图 10. 1 。 

这 两 种 方式 的 区 别 是 什么 呢 ? GPS_PROVIDER 提供 精确 的 GPS 定位 ,但 在 室内 几 
乎 无 法 定位 而 导致 无 法 收集 信息 , 即 有 定位 盲区 。GPS 定位 的 基本 原理 是 测量 出 已 知 位 
置 的 卫星 到 用 户 接收 机 之 间 的 距离 ,然后 综合 多 颗 卫 星 的 数据 就 可 知道 接收 机 的 具体 位 
置 。 要 达到 这 一 目的 ,卫星 的 位 置 可 以 根据 星 载 时 钟 所 记录 的 时 间 在 卫星 星 历 中 查 出 ,所 
以 使 用 必须 在 户外 。 而 NETWORK_PROVIDER 为 网 络 定位 ,其 偏差 较 大 ,但 无 定位 盲 
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10.1 设置 定位 方式 


代码 10.2 定位 服务 用 户 权限 设置 


<manifest …> 


<uses-permission 





区 ,只 要 有 网 络 一 般 都 可 以 收集 到 。 网 络 定位 简单 来 说 就 是 当前 接 人 Wi-Fi 就 使 用 


WirFi 定 位 ,当前 接 人 2G 或 3G 网 就 是 基站 定 
位 ,实际 上 基站 和 Wi-Fi 有 单独 的 定位 方式 ,只 
不 过 系统 都 封装 到 了 NETWORK_PROVIDER 
方法 中 。 

除了 requestLocationUpdates() 方 法 ,Location- 
Manager 类 还 提供 了 getLastKnownLocation() 
方法 ,来 获取 上 一 次 获取 到 的 位 置信 息 , 而 并 非 
当前 的 GPS 位 置信 息 。 

4. 用 户 权 限 设置 

为 了 从 NETWORK_PROVIDER 或 GPS_ 
PROVIDER 获取 位 置 更 新 ,必须 在 应 用 程序 的 
Manifest 文件 中 声明 用 户 访问 的 ACCESS_ 
COARSE_ LOCATION 或 ACCESS _FINE _ 
LOCATION 权限 ( 见 代码 10.2). 


android:name="android.permission.ACCESS_FINE_LOCATION" /> 


</manifest> 


如 果 在 应 用 程序 中 同时 使 用 NETWORK_PROVIDER 和 GPS_PROVIDER ,就 只 需 
声明 ACCESS_FINE_LOCATION 权限 。ACCESS_COARSE_LOCATION 只 包含 


NETWORK_PROVIDER 的 权限 。 


10.1.2 定位 最 佳 策略 


基于 位 置 的 应 用 可 谓 数不胜数 ,但 是 由 于 很 难 提供 最 佳 精度 .用户 位 置 的 移动 多 种 
方法 获取 用 户 位 置 和 尽 可 能 减少 耗 电 量 等 原因 ,使 得 获取 用 户 位 置 变 得 较为 复杂 。 要 既 
减少 电池 的 耗 电量 ,同时 又 获取 极 佳 用 户 位 置 ,必须 定义 一 个 长 效 模型 来 解决 多 种 难题 ， 
说 明 应 用 如 何 获取 用 户 的 位 置 。 当 启动 或 停止 监听 位 置 更 新 ,或 使 用 缓存 位 置 数据 时 ,此 
模型 会 被 使 用 。 下 面 是 获取 用 户 位 置 的 典型 流程 : 








(1) 启动 应 用 。 


(2) 一 段 时 间 后 ,开始 监听 定位 提供 者 获取 位 置信 息 。 
(3) 通过 去 除 不 够 准确 的 位 置 更 新 来 保持 以 最 佳 状态 去 获取 位 置信 息 。 


(4) 停止 监听 获取 位 置信 息 。 


(5) 采用 最 新 最 好 的 位 置 。 


图 10. 2 通过 使 用 时 间 线 展示 了 获取 用 户 位 置 更 新 的 流程 时 间 线 。 这 个 时 间 线 体现 
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了 应 用 监听 用 户 位 置 更 新 的 各 个 时 间 段 和 各 个 时 间 段 发 生 的 事件 。 


NewWiFibased 

Lisenfor = Cached GPS location is 

GPSand “ocationis dismissed due to 

Network dismissed as larger error Stop listening 

updates too old estimates for updates 

Appia Cached NewCelHD A WiFi-based AGPS Best estimate Time (t 
network fixis location is location ofthe location 
location is received obtained replaces is used in the 
retneved current best application 
estimate 


图 10.2 用 户 位 置 更 新 


在 接收 更 新 位 置信 息 的 这 段 时 间 ,需要 对 以 下 关键 点 做 出 决策 

1) 决定 开始 监听 更 新 的 时 刻 

应 用 程序 可 以 一 启动 就 开始 监听 用 户 位 置 更 新 ,也 可 以 仅 当 用 户 触发 特定 的 条 件 时 
才 启 动 监听 。 但 是 要 清楚 地 意识 到 两 点 : 第 一 点 是 长 时 间 的 监听 位 置 更 新 可 能 导致 耗 电 
量 急剧 上 升 ;第 二 点 是 短 时 间 的 监听 又 可 能 使 得 用 户 位 置 获取 的 准确 度 不 够 。 如 上 所 述 ， 
可 以 通过 调用 requestLocationUpdates() 开 始 监 听 更 新 。 代 码 如 下 : 


LocationProvider locationProvider=LocationManager .NETWORK PROVIDER; 
// 或 者 ,使 用 LocationManager .GPS_PROVIDER 
locationManager.requestLocationUpdates (locationProvider, 0, 0, 
locationListener); 


2) 通过 最 后 可 知 位 置 快速 修正 

位 置 监听 器 接收 第 一 次 位 置 更 新 所 花费 的 时 间 长 得 可 能 让 用 户 难 以 忍受 。 除 非 位 置 
监听 器 接收 到 一 个 更 精确 的 位 置信 息 ,应 用 程序 应 该 暂时 使 用 缓存 中 的 用 户 位 置信 息 ,这 
个 信息 可 以 通过 调用 getLastKnownLocation( ) 方 法 来 获取 。 


LocationProvider locationProvider=LocationManager .NETWORK PROVIDER; 
Location lastKnownLocation=locationManager.getLastKnownLocation 
(locationProvider); 


3) 决定 停止 监听 更 新 的 时 刻 

根据 应 用 程序 的 不 同 ,决定 什么 时 候 停止 监听 最 新 的 策略 可 能 非常 简单 ,也 可 能 十 分 
复杂 。 在 获取 位 置信 息 和 使 用 位 置信 息 之 间 加 入 一 点 时 间 的 延迟 ,可 能 提高 位 置 获取 的 
准确 度 。 持 续 监 听 会 消耗 大 量 的 电量 ,因此 只 要 获取 了 所 需 的 信息 ,应 该 通过 调用 
removeUpdates() 停 止 监听 更 新 ,代码 如 下 。 


// 移 除 先前 添加 的 监听 


locationManager.removeUpdates (locationListener); 


4) 保持 最 佳 的 估算 值 
最 新 获取 的 位 置信 息 可 能 是 最 精确 的 。 但 是 ,由 于 位 置 修正 的 精确 度 经常 变 化 ,最 新 
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获取 到 的 位 置信 息 并 不 一 定 都 是 最 准确 的 。 因 此 ,需要 基于 一 些 规范 添加 选择 位 置信 息 
的 逻辑 ,这 些 规范 可 以 根据 具体 的 应 用 和 现场 测试 的 实例 不 同 而 有 所 变化 。 下 面 是 确认 
位 置 修正 可 以 采用 的 步 又: 

(1) 检查 是 否 最 近 得 到 的 位 置信 息 明 显 比 以 前 的 要 新 。 

(2) 检查 位 置 精度 是 好 于 还 是 差 于 之 前 的 位 置信 息 。 

(3) 检查 最 新 的 位 置信 息 是 来 自 于 哪 一 个 提供 者 ,并 且 判 断 这 个 位 置信 息 相 比 之 前 
的 是 否 更 加 准确 可 靠 。 

代码 10. 3 是 符合 上 述 逻 辑 的 代码 实现 例子 ,说 明了 如 何在 应 用 程序 中 实现 预定 义 好 
的 策略 和 逻辑 。 

代码 10.3 位 置 修正 判断 逻辑 


private static final int TWO MINUTES=1000 * 60 * 2; 
/xx 判断 哪 一 种 位 置 读 取 方 式 比 当前 的 位 置 修复 更 加 准确 
* @param location 新 位 置 
* @param currentBestLocation 当前 的 位 置 ,此 位 置 需要 和 新 位 置 进行 比较 
* / 
protected boolean isBetterLocation (Location location, Location 
currentBestlocation) ( 
if (currentBestLocation==null) { 
//A new location is always better than no location 
return true; 


Ì 


// 检 查 最 新 的 位 置 是 比较 新 还 是 比较 旧 

long timeDelta=location.getTime()-currentBestLocation.getTime (); 
boolean isSignificantlyNewer=timeDelta>TWO MINUTES; 

boolean isSignificantlyOlder=timeDelta<- TWO MINUTES; 

boolean isNewer=timeDelta>0; 


// 如 果 当 前 的 位 置信 息 来 源 于 2min 前 ,使 用 最 新 位 置 
// 因 为 用 户 可 能 移动 了 
if (isSignificantlyNewer) { 
return true; 
// 如 果 最 新 的 位 置 也 来 源 于 2min 前 ,那么 此 位 置 会 更 加 不 准确 
} else if (isSignificantlyOlder) { 
return false; 
} 


// 检 查 最 新 的 位 置信 息 是 更 加 准确 还 是 不 准确 

int accuracyDelta= (int) (location.getAccuracy()-currentBestLocation. 
getAccuracy()); 

boolean isLessAccurate=accuracyDelta>0; 
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boolean isMoreAccurate=accuracyDelta<0; 


boolean isSignificantlyLessAccurate=accuracyDelta>200; 


// 检 查 旧 的 位 置 和 新 的 位 置 是 否 来 自 同一 个 Provider 
boolean isFromSameProvider=isSameProvider (location.getProvider(), 
currentBestLocation.getProvider()) 7 


// 结 合 及 时 性 和 精确 度 ,决定 位 置信 息 的 质量 

if (isMoreAccurate) { 
return true; 

} else if (isNewer && !isLessAccurate) { 
return true; 

} else if (isNewer && !isSignificantlyLessAccurate && isFromSameProvider) { 
return true; 

i) 

return false; 


) 


/xx # 检查 两 个 提供 者 是 否 是 同一 个 * / 
private boolean isSameProvider (String providerl, String provider2) { 
if (providerl==null) { 
return provider2==null; 
} 
return providerl.equals(provider2); 


5) 调整 模型 来 保存 电量 和 数据 交换 

当 测试 应 用 程序 的 时 候 , 可 能 会 在 模型 是 要 提供 更 佳 的 位 置信 息 还 是 更 佳 的 效率 之 
间 做 出 选择 调整 。 

6) 减少 窗口 的 大 小 

在 一 个 较 小 的 窗口 下 监听 位 置 更 新 ,意味 着 与 GPS 或 者 网 络 定位 服务 进行 更 少 的 交 
互 ,这 样 就 可 以 保存 电池 电量 。 但 是 这 样 会 使 得 可 选 位 置 变 少 ,从 而 导致 获取 最 佳 位 置信 
息 变 得 困难 。 

7) 减少 位 置 提供 者 的 更 新 频率 

在 窗口 中 减少 更 新 出 现 的 频率 也 可 以 提高 电池 使 用 效率 ,但 是 这 样 会 牺牲 精确 度 。 
两 者 之 间 的 权衡 要 依赖 于 具体 的 实际 应 用 。 可 以 通过 增加 requestLocationUpdates O Pñ 
数 的 第 二 个 和 第 三 个 参数 的 值 来 减少 更 新 的 频率 。 

8) 仅 支 持 一 种 位 置信 息 提 供 者 

根据 应 用 程序 的 使 用 场景 和 对 精度 的 要 求 ,也许 只 需要 在 网 络 定位 提供 者 和 GPS 之 
间 选 择 一 种 提供 者 ,而 不 是 两 者 都 需要 。 只 和 其 中 的 一 种 服务 进行 交互 可 以 大 大 减少 耗 
电 的 可 能 性 。 
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10.13 ”调试 位 置 数据 


在 开发 应 用 的 过 程 中 ,需要 对 获取 用 户 位 置 的 模型 进行 效率 测试 。 最 简单 的 测试 就 
是 使 用 Android 真 机 设备 。 但 是 如 果 没 有 一 个 真正 的 物理 设备 ,也 可 以 使 用 Android 虚 
拟 机 的 虚拟 位 置 进行 基于 用 户 位 置 的 测试 。 向 应 用 提供 模拟 位 置 数据 的 方法 主要 有 三 
种 : Eclipse, DDMS 或 者 模拟 器 控制 台 的 geo 命令 行 。 由 于 提供 模拟 位 置 数据 使 用 的 是 
GPS 的 数据 类 型 ,所 以 必须 使 用 GPS_PROVIDER 来 获取 位 置 更 新 ,否则 模拟 数据 无 法 
THE. 

如 果 使 用 Eclipse, 选 择 Windows->ShowView->Other->Emulator Control。 在 模拟 
器 控制 面板 上 ,在 位 置 控制 (Location Controls) F A GPS 坐标 ,GPX 文件 中 是 路 径 回 
放 ,KML 文 件 中 是 多 个 位 置 的 记录 。 确 认 在 设备 面板 下 已 经 有 设备 被 选择 ,选择 
Windows->Show View—Other—Devices 可 以 获得 相关 的 信息 。 如 果 使 用 DDMS 工具 ， 
可 以 使 用 多 种 方法 模拟 位 置 数 据 , 其 中 包括 向 设备 手动 发 送 独立 的 经 纬度 ;使 用 GPX 文 
件 向 设备 发 送 的 一 系列 路 径 ; 使 用 KML 文件 向 设备 发 送 独立 的 一 序列 化 的 路 径 位 置 。 
如 果 使 用 模拟 器 控制 台 的 geo 命令 行 发 送 模拟 位 置 数据 ,需要 在 Android 模拟 器 上 装载 
应 用 ,并 在 sdk 下 的 /tools 目录 下 打开 设备 终端 的 控制 台 ,连接 到 模拟 器 控制 台 : 


telnet localhost<console-port> 


然后 向 模拟 控制 台 发 送 位 置 数 据 。geo fix 命令 发 送 固定 的 geo 位 置 。 这 个 命令 接 
收 十 进 制 的 经 度 和 纬度 ,和 一 个 可 选 的 海拔 (单位 m) ,例如 : 


geo fix-121.45356 46.51119 4392 
geo nmea 发 送 一 个 NMEA 0183 句子 ,例如 : 


geo nmea $ GPRMC,081836,A,3751.65,S,14507.36,E,000.0,360.0,130998,011.3,E* 
62 


10.14 实现 位 置信 息 获 取 


前 面 对 有 关 定 位 服务 的 位 置信 息 服 务 进 行 了 阐述 ,下 面 利用 一 个 简单 的 例子 把 这 些 
知识 连贯 起 来 。 该 例 可 以 在 屏幕 上 显示 手机 设备 当前 位 置 的 经 纬度 , 当 按 下 按钮 时 ,屏幕 
显示 出 当前 经 纬度 对 应 的 地 址 信息 。 下 面 是 具体 的 步骤 。 

1. 设置 用 户 权限 

在 应 用 程序 的 AndroidManifest. xml 文件 中 ,添加 设置 访问 位 置 提供 器 的 权限 内 容 
( 见 代 码 10.2). 

2. 定义 布局 等 资源 文件 

在 /res/layout 中 定义 用 户 界 面 的 布局 文件 activity_main. xml, 在 界面 上 定义 一 个 按 
#H show_address_button 一 个 用 于 响应 从 位 置 提供 的 信息 中 获取 当前 位 置信 息 后 ,在 界 
面 上 显示 当前 位 置 的 经 纬度 以 及 设备 所 在 的 地 址 。 
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3. 创建 或 打开 Activity, RRRA R 

创建 显示 用 户 界面 的 Activity FÆ ShowLocationActivity, 并 导入 activity _ main. 
xml 定义 的 布局 文件 ,获取 按钮 对 象 , 并 分 别 赋值 给 showAddrBtn 变量 。 

4. 获取 LocationManager 对 象 

从 系统 获取 LocationManager 对 象 ,并 创建 Criteria 对 象 ,根据 其 精度 和 电池 耗 电 量 
的 标准 ,使 用 LocationManager 的 getBestProvider () 方 法 选取 系统 中 最 符合 要 求 的 
LocationProvider( 见 代码 10. 4) 。 

代码 10.4 初始 化 提供 位 置 服务 的 对 象 



































LocationManager locationManager = (LocationManager ) getSystemService 
(Context .LOCATION SERVICE); 


Criteria criteria=new Criteria(); 
provider=locationManager.getBestProvider(criteria, false); 


Location location=locationManager.getLastKnownLocation (provider); 


5. 定义 自己 的 LocationListener 

在 ShowLocationActivity 中 创建 自己 的 MyLocationListener ,实现 LocationListener 
的 接口 , 当 位 置 发 生变 化 时 ,把 经 纬度 显示 在 屏幕 上 ( 见 代 码 10. 5) 。 

代码 10.5 自 定义 LocationListener 


private class MYLocationListener implements LocationListener { 
@override 
public void onLocationChanged(Location location) { 
String showLocation="Current Location \n Latitude: "+location. 
getLatitude () +"\n Longitude: "+location.getLongitude(); 
Toast .makeText (this,showLocation ， 
Toast .LENGTH SHORT) . show () ; 


@override 
public void onProviderEnabled(String provider) { 
Toast.makeText (this, "Enabled new provider "+provider, 
Toast.LENGTH_SHORT) . show () ; 


Qoverride 
public void onProviderDisabled(String provider) { 
Toast.makeText (this, "Disabled provider "+provider, 
Toast.LENGTH SHORT) . show () ; 


Boverride 
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6. 将 MyLocationLister 注册 到 当前 的 LocationManager 对 象 

在 ShowLocationActivity 的 onResume() 方 法 中 注册 位 置 监 听 器 ,并 设 定位 置 更 新 
信息 获取 的 方式 和 间隔 ;在 onPause() 方 法 中 删除 监听 器 监听 位 置 更 新 信息 ,在 
ShowLocationActivity 界面 处 于 暂停 状态 时 减少 电池 耗 电量 ( 见 代码 10.6). 

代码 10.6 注册 监听 器 





7. 定义 按钮 的 监听 器 

在 ShowLocationActivity 的 onCreate ( ) 方法 中 使 用 匿名 内 部 类 的 方式 ,定义 
showAddrBtn 按钮 的 单 击 监 听 器 ,通过 当前 的 经 纬度 获得 确切 的 地 址 。 由 于 实现 经 纬度 
与 地 址 转化 的 代码 比较 烦琐 ,定义 一 个 private 的 方法 getAddress() 来 实现 ( 见 代 码 10.7) 。 

代码 10.7 经 纬度 转换 为 地 址 
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Location currentLoc=locationManager .getLastKnownLocation (provider); 
Geocoder geocoder=new Geocoder (getBaseContext (), Locale.getDefault ()); 


try{ 
List<String>addresses=new ArrayList<String> (); 


List<Address>addr=geocoder .getFromLocation (currentLoc.getLatitude ()， 
currentLoc.getLongitude(), 3); 


if (addr !=nul1)( 
for (Address address:addr){ 
String placeName=address.getLocality(); 
String featureName=address.getFeatureName (); 
String country=address.getCountryName (); 
String road=address.getThoroughfare (); 
String locationInfo=String.format("NVn[%s] [$s] [bs] [%s]", 
placeName, featureName, road, country); 


1 
return locationInfo; 
$ 
catch (Exception e){ 
throw new RuntimeException (e); 
} 


运行 ShowLocationActivity, 观 察 结 果 。 


10.2 Google 地 图 


基于 位 置 的 服务 (Location Based Service,LBS) 是 通过 电信 移动 运营 商 的 无 线 电 通 
信 网 络 ( 如 GSM 网 .CDMA 网 ) 或 外 部 定位 方式 (如 GPS) 获 取 移 动 终端 用 户 的 位 置信 
息 , 即 地 理 坐 标 或 大 地 坐标 ,在 GIS 平台 的 支持 下 ,为 用 户 提 供 相 应 服务 的 一 种 增值 业 
务 。 由 于 LBS 与 地 理 位 置 直接 相关 ,其 应 用 开发 都 离 不 开 地 图 。 

使 用 Google Maps Android API, 可 以 基于 Google 地 图 (Google Maps) 的 数据 ,在 应 
用 中 添加 地 图 功能 。Google Maps Android API 可 以 自动 处 理 对 Google Maps 服务 器 的 
访问 .数据 下 载 ` 地 图 显示 和 地 图 手势 的 事件 响应 。 这 些 API 还 支持 在 基础 地 图 上 添加 
标记 、 多 边 形 和 图 层 ,改变 用 户 查 看 地 图 区 域 的 视角 。 这 些 对 象 给 地 图 位 置 提供 额外 的 信 
息 ,允许 用 户 与 地 图 交互 。 

本 节 着 重 介 绍 Google Maps Android API( 以 下 简称 Maps API) 中 重要 的 类 ,以 及 如 
何 使 用 Google Maps。 
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10.21 API 中 的 重要 类 


在 API 中 ,Maps 是 由 GoogleMap 和 MapFragment 类 来 描述 的 。 使 用 这 些 Maps 
API, 就 可 以 在 Android 应 用 程序 中 显示 出 与 直接 访问 Google Maps 完全 相同 的 外 观 。 

1. GoogleMap 类 

GoogleMap 是 Maps API 的 主 类 ,是 所 有 与 地 图 操作 相关 方法 的 入 口 。 当 对 Map 对 
象 进行 操作 时 ,在 应 用 程序 中 根据 它 构建 地 图 对 象 。GoogleMap 对 象 不 能 够 使 用 构造 方 
法 直接 创建 ,需要 使 用 应 用 程序 中 的 MapFragment 或 MapView 的 getMap() 获得 。 

GoogleMap 可 以 自动 处 理 下 面 的 操作 : 

。 连接 到 Google Maps 服务 ; 

。 下载 地 图 图 块 ; 

。 在 设备 屏幕 上 显示 地 图 图 块 ; 

。 变化 显示 控制 ,例如 平移 和 缩放 ; 

。 响应 平移 和 缩放 手势 。 

2. MapFragment 类 

MapFragment 类 是 Fragment 类 的 子 类 , MapFragment 对 象 作为 地 图 的 容器 ,提供 
对 GoogleMap 对 象 的 访问 。 在 Android 用 户 界面 设计 中 使 用 Fragment 具有 很 大 的 灵活 
性 ,可 以 在 一 个 Activity 中 放置 多 个 Fragment, 创建 多 个 窗 格 的 显示 界面 ;同时 ,一 个 设 
计 好 的 Fragment 还 可 以 在 多 个 Activity 中 重用 。 

在 XML 布局 资源 文件 中 说 明 一 个 Fragment 组 件 ,可 以 使 用 二 fragment 过 元素 将 其 
添加 到 XML 文件 中 ( 见 代 码 10.8). 

代码 10.8 MapFragment 布局 定义 


<fragment 
class="com.google.android.gms.maps.MapFragment" 
android:layout_width="match parent" 
android:layout height="match Parent"/> 


MapFragment 类 会 自动 初始 化 地 图 系统 和 视图 ,但 由 于 初始 化 过 程 依赖 于 Google 
Play services APK ,初始 化 完成 的 时 间 无 法 确定 。 只 有 当 相 关 的 地 图 系统 已 经 装载 、 
Fragment 中 相关 的 视图 存在 时 ,MapFragment 才能 够 使 用 getMap() 获 得 GoogleMap 对 
象 。 如 果 无 法 获得 GoogleMap 对 象 ,getMap() 方法 返回 空 值 。 

当 设 置 ViewLifecycleInFragment() 选 项 时 ,MapFragment 可 以 调用 onDestroyView() 
方法 删除 当前 视图 。 只 有 当 MapFragment 调用 onCreateView() 方 法 重新 创建 视图 后 ， 
MapFragment 才 有 效 。 

如 果 编 译 目标 早 于 API 12 之 前 的 应 用 程序 ,可 以 使 用 SupportMapFragment 类 获得 
相同 的 功能 ,但 是 必须 在 项 目 中 包括 Android 的 支持 库 。 

3. MapView 类 

MapView 类 是 View 类 的 一 个 子 类 ,允许 将 地 图 放 在 视图 中 。 视 图 是 屏幕 的 一 个 矩 
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形 区 域 , 是 Android 应 用 程序 和 部 件 的 基本 构建 块 。 与 MapFragment 类 似 ,MapView 也 
是 作为 地 图 容器 ,通过 GoogleMap 的 对 象 呈 现 出 地 图 的 核心 功能 。 
如 果 使 用 MapView 类 ,必须 将 包含 这 个 视图 的 Activity 或 Fragment 的 生命 周期 中 
所 有 方法 的 代码 ,在 MapView 对 应 的 方法 中 同样 实现 。 例 如 ,一 个 MapView 是 一 个 
Activity 中 的 视图 对 象 , 此 MapView 则 必须 在 onCreate() 方 法 中 ,编写 与 该 Activity 的 
onCreate() 方 法 中 同样 的 代码 ;以 此 类 推 到 生命 周期 中 其 他 的 方法 。 在 MapView 类 中 ， 
下 面 这 些 方法 必须 要 与 其 上 层 的 Activity 或 Fragment 中 的 代码 一 致 : onCreate 
(Bundle) .onResume() .onPause() .onDestroy() ,onSavelInstanceState( ) 和 onLowMemory() 。 
4. Marker 类 
Marker 类 是 用 于 表示 地 图 上 特定 点 的 图 标 ,可 以 称 为 标记 。Marker 不 会 随 着 地 图 
的 旋转 、 分 块 或 缩放 发 生 改 变 。Marker 对 象 具有 以 下 属性 : 
。 Anchor: 被 放置 在 标记 经 纬度 上 的 图 片 的 点 。 默 认 在 图 片 的 底部 , 偏 左 位 置 。 
Position: 地 图 上 标记 的 经 纬度 ,可 以 改变 其 值 ,移动 标记 。 
Title; 用 户 单 击 标 记 时 ,显示 的 文本 说 明 。 
Snippet: 在 Title 下 显示 的 额外 信息 。 
Icon: 显示 标记 的 位 图 。 
Drag Status: 如 果 人 允许 用 户 拖 动 标记 ,此 属性 设置 为 true, 
Visibility: 默认 值 为 true, 标 记 可 视 。 
代码 10. 9 是 一 个 在 地 图 上 添加 标记 的 例子 代码 。 
代码 10.9 添加 标记 


GoogleMap map=… //get a map. 

//Add a marker at San Francisco. 

Marker marker=map.addMarker (new MarkerOptions () 
.position (new LatLng (37.7750, 122.4183)) 
.title("San Francisco") 

.snippet ("Population: 776733")); 


Marker 类 的 使 用 会 在 本 章 后 面 详 述 。 
10.2.2 使 用 Google Maps API 


本 节 使 用 一 个 简单 的 例子 ,来 说 明 如 何在 用 户 界面 上 添加 地 图 功能 。 这 个 例子 实现 
了 在 用 户 界面 上 按照 某 个 经 纬度 显示 标记 的 功能 。 

1. 创建 Google Maps Activity 

在 创建 project 时 从 图 10. 3 左 图 选择 Google Map Activity, 或 如 图 10. 3 右 图 在 
Project 中 添加 Google Map Activity。 本 例 中 使 用 图 10. 3 右 图 中 的 方法 ,创建 一 个 新 的 
Activity ,命名 为 MapOneActivity。 

完成 MapOneActivity 的 创建 后 , Android Studio 自动 生成 了 MapOneActivity. java 
和 对 应 的 布局 文件 ,以 及 与 Map 服务 相关 的 google_maps_api. xml 文件 ,并 在 Manifest 
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文件 中 添加 相应 的 信息 。 默 认 情 况 下 , Android Studio 在 布局 文件 中 简单 定义 一 个 
Fragment 来 承载 GoogleMap 对 象 ,在 MapOneActivity. java 添加 获取 地 图 Fragement 和 
响应 地 图 事件 的 接口 OnMapReadyCallback, 见 代码 10. 10 和 代码 10. 11 。 
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Æ 10.3 创建 Google Maps Activity 
代码 10.10 ”默认 布局 文件 


<fragment xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:map="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/map" 
android:name="com.google.android.gms.maps.SupportMapFragment" 
android:layout width="match parent" 
android:layout height="match parent" 
tools:context="cn.edu.uibe.cl0gmap.MapOneActivity" /> 


代码 10.11 默认 Activity 代码 


public class MapOneActivity extends FragmentActivity 
implements OnMapReadyCallback { 


private GoogleMap mMap; 


@override 
protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity_map_one); 
//Obtain the SupportMapFragment and get notified when the map is 
ready to be used. 
SupportMapFragment mapFragment 
= (SupportMapFragment) getSupportFragmentManager () 
.findFragmentById(R.id.map); 
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mapFragment .getMapAsync (this); 
i 


ww. N, 

@override 

public void onMapReady (GoogleMap googleMap) { 
mMap=googleMap; 


//Add a marker in Sydney and move the camera 

LatLng sydney=new LatLng(-34, 151); 

mMap.addMarker (new MarkerOptions ().position(sydney).title ("Marker 
in Sydney")); 

mMap.moveCamera (CameraUpdateFactory.newLatLng (sydney)); 


} 


代码 10.11 中 的 onCreate() 方 法 中 ,除了 获取 布局 文件 定义 的 界面 定义 之 外 ,还 在 接 
口 OnMapReadyCallback 的 onMapReady() 方 法 中 定义 了 一 个 位 置 对 象 , 使 用 Marker 在 
地 图 上 进行 标记 。 

这 时 ,程序 还 不 能 正常 运行 ,无 法 使 用 地 图 。 如 果 要 看 到 Google 地 图 ,需要 从 
Google 网 站 获取 API Key。 

2. 获取 API Key 

完成 GoogleMap Activity 的 创建 之 后 ,要 使 用 Google 公司 的 地 图 资源 和 功能 ,需要 
从 Google 公司 的 网 站 上 申请 使 用 GoogleMap 的 密 钥 ,也 就 是 获取 GoogleMap API key, 
这 一 步 非常 重要 ,是 获得 Google 公司 地 图 服务 的 许可 、 能 够 使 用 Google 地 图 服务 的 关 
键 。 值 得 注意 的 是 ,申请 API key 之 前 ,首先 要 具有 Google 的 账号 ,所 有 的 操作 都 需要 在 
登录 Google 之 后 进行 。 

具体 的 申请 过 程 如 下 : 

(1) 打开 \res\value\google_maps_api. xml 文件 ,选取 复制 深 色 标 注 的 内 容 , 见 
图 10.4。 

在 安装 Android 的 开发 环境 时 都 会 有 一 个 系统 默认 的 证 书 , 相 当 于 签名 ,用 于 标记 程 
序 的 开发 者 。 选 取 的 内 容 中 ,包含 这 个 证 书 里 唯一 的 key, 通 过 这 个 key(MD5 认证 指 
纹 ) ,到 Google 的 Android Map API key 申请 App 需要 的 密 钥 。 

(2) 打开 浏览 器 ,将 复制 的 内 容 复制 到 浏览 器 的 地 址 栏 中 ,出 现 该 Google API 的 注 
册 界 面 , 见 图 10.5. 

(3) 单 击 Continue 按钮 , 出现 界 面 图 10. 6, 单 击 Create 按钮 ,得 到 所 创建 的 本 App 
的 Google API key, 见 图 10.7。 

(4) 把 图 10.7 中 编辑 框 中 的 API key 复制 到 图 10. 4 中 矩形 框 标注 的 位 置 ,覆盖 
YOUR_KEY_HERE。 

到 此 为 止 , 就 完成 了 API key 的 获取 ,所 申请 的 App 获得 了 Google 地 图 的 使 用 权 ， 
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图 10.4 google_ maps_api. xml 代码 





Register your application for Google Maps Android API in Google API 
Console 

Google API Console allows you to manage your application and monitor API 
usage 


Select a project where your application will be registered 
You can use one project to manage all of your applications, or you can create a 
different project for each application 


Create a project ~ 





Æ 10.5 Google API 注册 界面 


可 以 通过 网 络 调用 Google Map API 提供 的 一 系列 功能 和 资源 。 

运行 MapOneActivity, 就 能 够 看 到 悉尼 的 地 图 了 。 

3. 设置 初始 状态 

在 Maps API 的 应 用 中 ,可 以 设 定 地 图 的 初始 状态 ,以 满足 应 用 程序 的 需求 。 这 其 中 
包括 摄像 机 的 位 置 缩放、 方位 和 倾斜 ,地 图 显示 类 型 ,是 否 缩放 按钮 .罗盘 显示 在 屏幕 上 ， 
用 户 使 用 的 手势 等 ,用 来 操作 相机 。 可 以 通过 XML 布局 文件 设置 初始 状态 ,也 可 以 通过 
编程 的 方式 实现 。 
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E 10.7 API key 的 值 


D 通过 XML 布局 文件 设置 初始 状态 
如 果 使 用 XML 布局 文件 添加 了 地 图 应 用 ,地 图 为 MapFragment 和 MapView 定义 
了 一 组 自 定义 的 XML 属性 ,可 以 在 布局 文件 中 直接 定义 初始 状态 。 目 前 这 些 属性 包括 ， 


mapType: 可 以 指定 地 图 类 型 的 种 类 ,其 值 可 以 是 none, normal, satellite 和 


terrain。 


cameraTargetLat, cameraTargetLng, cameraZoom, cameraBearing, cameraTilt, 


可 以 指定 初始 摄像 机 的 位 置 。 
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。 uiZoomControls,uiCompass: 可 以 指定 是 否 要 在 地 图 上 显示 缩放 控制 和 指南 针 。 
e uiZoomGestures, uiScrollGestures, uiRotateGestures , uiTiltGestures: 可 以 指定 
各 种 与 地 图 交换 手势 的 启用 或 禁用 。 
zOrderOnTop :控制 地 图 视图 的 表面 是 否 被 放置 在 其 窗口 的 顶部 。 
useViewLifecycle: 只 适用 于 MapFragment。 此 属性 指定 是 否 应 该 将 地 图 的 生命 
周期 连接 到 片段 的 视图 或 片段 本 身 。 

为 了 在 XML 布局 文件 中 使 用 这 些 自 定义 的 属性 ,必须 首先 添加 下 面 的 命名 空间 声 
明 。 命 名 空间 的 名 称 可 以 任何 选择 ,不 一 定 是 map, 


xmlns:map="http://schemas.android.com/apk/res-auto" 


如 果 命 名 空间 的 名 称 为 map, 则 使 用 “map:” 作 为 前 级 添加 地 图 属性 。 

在 上 一 小 节 例 子 的 基础 上 ,修改 布局 文件 activity_map_one. xml 中 的 代码 ,添加 地 图 
的 属性 设置 ,使 地 图 显示 时 按 定义 的 格式 显示 大 小 和 模式 ,具体 设置 见 代 码 10. 12。 

代码 10.12 地 图 属性 初始 化 


<fragment xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:map="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/map" 
android:name="com.google.android.gms.maps.SupportMapFragment" 
android:layout_width="match_parent" 
android:layout _ height="match parent" 
tools:context="cn.edu.uibe.cl0gmap.MapTwoActivity" 
map:cameraBearing="112.5" 
map:cameraTargetLat="-34" 
map:cameraTargetLng="151" 
map:cameraTilt="30" 
map:cameraZoom="10" 
map:mapType= "hybrid" 
map:uiCompass="true" 
map:uiRotateGestures="true" 
map:uiScrollGestures="false" 
map:uiTiltGestures="true" 
map:uiZoomControls="true" 
map:uiZoomGestures="true" /> 


再 次 运行 MapOneActivity, 可 以 看 到 图 10.8 右 图 的 效果 。 图 10. 8 右 图 与 左 图 相 
比 ,显示 比例 增 大 ,显示 的 地 图 类 型 是 卫星 照片 和 数据 ,显示 的 角度 发 生 了 改变 ,并 具有 放 
大 和 缩小 按钮 。 这 些 变化 都 是 通过 在 XML 布局 文件 代码 10. 14 一 一 设置 的 。 转 动 
图 10. 8 右 图 中 的 指 北 针 ,可 以 调整 地 图 的 显示 方位 , 单 击 右 下 角 的 放大 “十 ”和 缩小 “一 ” 
标记 ,可 以 放大 和 缩小 地 图 的 显示 比例 。 





第 70 章 “定位 服务 与 6ooge 地 图 NM 
— 





图 10.8 MapOneActiivty 运行 效果 


2) 通过 编程 的 方式 设置 初始 状态 

如 果 要 通过 编程 的 方式 配置 MapFragment 或 MapView 的 初始 状态 ,需要 定义 
GoogleMapOptions 对 象 ,并 且 使 用 此 对 象 创 建 MapFragment 或 MapView。 首 先 需 要 创 
建 GoogleMapOptions X% ,代码 如 下 : 


GoogleMapOptions options=new GoogleMapOptions () ; 


然后 为 GoogleMapOptions 对 象 增加 配置 项 ,代码 如 下 : 


options .mapTYPe (GoogleMap.MAP_TYPE_SATELLITE) 
.compassEnabled (false) 
.rotateGesturesEnabled (false) 
.tiltGesturesEnabled (false); 


地 图 显示 的 类 型 ,也 可 以 通过 Java 代码 来 实现 。 在 Google Map Android API 中 提 
供 了 五 种 类 型 的 地 图 。 

。 MAP_TYPE_NORMAL: 典型 的 路 线 图 ,其 显示 道路 、 某 些 人 造 的 以 及 重要 的 自 
然 特 征 , 例 如 河流 等 。 公 路 和 特征 的 标签 也 是 可 见 的 。 
MAP_TYPE_HYBRID: 在 路 线 图 上 增加 了 卫星 照片 数据 ,公路 和 特征 的 标签 也 
是 可 见 的 。 
MAP_TYPE_SATELLITE: 卫星 照片 数据 ,公路 和 特征 的 标签 是 不 可 见 的 。 
MAP_TYPE_TERRAIN: 地 形 数据 。 该 地 图 包含 的 颜色 .轮廓 线 和 标签 .透视 阴 
影 。 某 些 道路 和 标签 也 是 可 见 的 。 
MAP_TYPE_NONE: 没有 图 块 。 该 地 图 将 呈现 为 一 个 空 的 网 格 没有 图 块 的 
加 载 。 
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要 设置 地 图 的 类 型 ,可 以 调用 GoogleMap 对 象 的 setMapType() 方 法 ,并 且 传 递 地 图 
类 型 常量 。 例 如 ,要 显示 卫星 地 图 ,设置 代码 如 下 : 


GoogleMap map; 


//Sets the map type to be "hybrid" 
map.setMapType (GoogleMap .MAP TYPE HYBRID); 


4. 获取 GoogleMap 对 象 

在 Android Studio 中 ,初始 创建 Google Map Activity 时 ,平台 会 在 Activity 后 默认 
实现 一 个 接口 OnMapReadyCallback。onMapReady 是 接口 OnMapReadyCallback 中 需 
要 实现 的 抽象 方法 ,一 旦 App 通过 onCreate() 方 法 完成 初始 化 ,成 功 获取 Google 地 图 
后 ,系统 就 会 回调 这 个 方法 ,对 地 图 进行 操作 。 在 onMapReady() 方 法 中 ,可 以 添加 标记 
和 线条 ,添加 监听 器 或 移动 照相 机 。 

因为 是 在 地 图 可 用 后 系统 才 会 调用 onMapReady() 方 法 ,所 以 在 这 个 方法 中 可 以 直 
接 通过 系统 传递 的 参数 获取 GoogleMap 对 象 。 在 10. 2. 2 节 的 MapOneActivity 中 ， 
onMapReady() 方 法 中 通过 赋值 语句 直接 把 googleMap 赋值 给 成 员 变 量 mMap, 通 过 
mMap 的 addMarker() 方 法 给 悉尼 标注 了 一 个 标记 , 见 代码 10. 13。 

代码 10.13 获取 GoogleMap 对 象 


METOE Y] 
@override 
public void onMapReady (GoogleMap googleMap) { 
mMap=googleMap; 


//Add a marker in Sydney and move the camera 

LatLng sydney=new LatLng(-34, 151); 

mMap.addMarker (new MarkerOptions ().position (sydney).title ("Marker 
in Sydney")); 

mMap.moveCamera (CameraUpdateFactory.newLatLng (sydney)); 


} 


5. 地 图 标记 

标记 可 以 用 来 识别 地 图 上 的 某 一 位 置 。 其 使 用 标准 的 图 标 , 与 常见 的 Google 地 图 的 
外 观 相似 ,可 以 通过 API 改变 标记 的 颜色 .图片 或 锚 点 , 自 定义 图 像 。 标 记 是 Marker 类 
型 的 对 象 ,通过 GoogleMap. addMarker(markerOptions) 方 法 添加 到 地 图 上 。 标 记 的 图 
标 是 针对 设备 的 屏幕 绘制 的 ,而 不 是 在 地 图 的 表面 ,所 以 地 图 发 生 了 旋转 、 倾 斜 或 变焦 不 
一 定 会 改变 标记 的 方向 。 在 例子 MapOneActivity 的 onMapReady ( ) 方 法 中 , 使 用 
addMarker 在 悉尼 的 经 纬度 上 添加 了 红色 的 标记 , 见 代 码 10.11 和 图 10. 8 。 

当 用 户 在 地 图 上 单 击 一 个 标记 时 ,可 以 使 用 信息 窗口 给 用 户 显示 信息 。 上 默认 情况 下 ， 
如 果 标 记 有 一 个 标题 , 当 用 户 单 击 一 个 标记 时 ,消息 窗口 被 显示 ,而 且 同 一 时 间 只 显示 一 
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个 信息 窗口 。 如 果 用 户 单 击 另 一 个 标记 ,当前 标记 的 消息 窗口 会 被 隐藏 ,新 的 消息 窗口 将 
显示 。 可 以 通过 调用 标记 的 showInfoWindow () 方 法 显示 信息 窗口 ,通过 调用 
hideInfoWindow() 方 法 隐藏 消息 窗口 。 消 息 窗口 与 标记 一 样 ,是 被 绘制 在 设备 屏幕 上 ， 
是 在 标记 中 心 的 上 面 。 默 认 的 消息 窗口 包含 黑体 的 标题 , 在 标题 下 面 也 可 以 有 一 小 段 
文本 。 

如 果 将 标记 的 draggable 属性 设置 为 true, 则 允许 用 户 更 改 标记 的 位 置 ; 如 果 对 标记 
进行 长 按 操 作 ,可 以 激活 移动 功能 。 代 码 10. 14 中 为 地 图 添加 了 一 个 标记 ,其 坐标 为 (0， 
0) , 当 单 击 时 在 消息 窗口 上 显示 字符 串 “Hello world”, 

代码 1.14 添加 标记 


private GoogleMap mMap; 
mMap= ((MapFragment) getFragmentManager () . findFragmentById (R. id. map)). 
getMap () 7 
mMap .addMarker (new MarkerOptions () 
.position (new LatLng (0, 0)) 
«title ("Hello world")); 


如 果 改 变 默认 的 标记 图 像 的 颜色 ,需要 传递 BtmapDescriptor 对 象 给 icon( ) 方 法 。 可 以 
在 BitmapDescriptorFactory 对 象 上 使 用 一 组 预定 义 颜 色 , 或 使 用 BitmapDescriptorFactory. 
defaultMarker(float hue) 方 法 设置 一 个 自 定义 的 标记 颜色 ,色调 的 值 介 于 0 一 360, 见 代 
码 10.15。 

代码 1.15 改变 标记 颜色 


static final LatLng MELBOURNE=new LatLng (- 37.81319, 144.96298); 
Marker melbourne=mMap.addMarker (new MarkerOptions () 
.Position (MELBOURNE) 
.title("Melbourne") 
.snippet ("Population: 4,137,400") 
.icon (BitmapDescriptorFactory .defaultMarker (BitmapDescriptorFactory. 
HUE_AZURE))); 


如 果 想 设置 更 多 标记 的 属性 ,而 不 仅仅 是 颜色 ,可 以 设置 一 个 自 定义 标记 图 像 , 它 通常 
被 称 为 图 标 。 这 种 自 定义 图 标 被 设置 为 BitmapDescriptor, 可 以 由 BitmapDescriptorFactory 
类 的 下 面 四 种 方法 之 一 定义 。 

。 fromAsset(String assetName): 创建 一 个 自 定 义 的 标记 ,使 用 的 资产 目录 中 的 
图 像 。 
fromBitmap (Bitmapimage) : 从 位 图 图 像 创 建 一 个 自 定义 的 标记 。 
fromFile (Stringpath) : 在 指定 的 路 径 从 一 个 文件 创建 一 个 自 定 义 图 标 。 
e fromResource(int resourceld) : 创建 一 个 自 定义 的 标记 ,使 用 现 有 的 资源 。 
代码 10. 16 中 , 列 出 了 创建 一 个 自 定义 图 标的 代码 。 


` 
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代码 10.16 创建 一 个 自 定义 图 标 


private static final LatLng MELBOURNE=new LatLng (- 37.81319, 144.96298); 
private Marker melbourne=mMap.addMarker (new MarkerOptions () 
.Position (MELBOURNE) 
.title ("Melbourne") 
.Snippet ("Population: 4,137,400") 
.icon (BitmapDescriptorFactory.fromResource (R.drawable.arrow))); 


在 应 用 程序 中 也 可 以 监听 和 响应 地 图 标记 上 的 事件 。 要 监听 这 些 事件 ,必须 为 标记 
在 GoogleMap 的 对 象 上 设置 相应 的 监听 器 。 当 事件 发 生 在 地 图 上 的 一 个 标记 时 ,监听 器 
的 回调 方法 将 会 被 调用 ,并 且 传 人 相应 的 标记 对 象 作为 参数 。 在 判断 标记 引用 时 ,必须 使 
用 此 标记 的 equals() 方 法 ,而 不 是 “二 = 二”。 可 以 监听 的 事件 包括 标记 单 击 事件 、 标 记 拖 动 
事件 、 信 息 窗 口 的 单 击 事件 。 

Maps API 针 对 不 同 的 操作 提供 不 同 的 监听 器 。 监 听 器 OnMarkerClickListener 
可 以 监听 标记 的 单 击 事 件 OnMarkerDragListener 监听 标记 拖 动 事件 ， 
OnInfoWindowClickListener 监听 信息 窗口 的 单 击 事件 。 在 默认 情况 下 ,标记 是 不 能 拖 
动 的 。 必 须 明确 地 设置 为 可 拖 动 ,标记 才 可 以 由 用 户 拖 动 。 

6. 调整 布局 文件 

在 MapOneActivity 例子 中 ,使 用 MapFragment 来 显示 地 图 。 如 果 要 在 Activity 中 
添加 其 他 的 图 形 组 件 ,需要 进一步 调整 activity_map_one. xml 的 内 容 , 增 加 布局 管理 器 ， 
再 在 布局 管理 器 中 添加 图 形 组 件 和 容纳 地 图 的 一 fragment 之 元 素 。 在 王 fragment 之 元 素 中 ， 
需要 设置 android : name 的 属性 值 为 com. google. android. gms. maps. SupportMapFragment, 
使 MapFragment 自动 附加 到 Activity 中 。 

在 MapOneActivity 例子 的 基础 上 ,添加 一 个 TextView, 显示 手机 当前 位 置 的 经 纬 
度 和 地 址 信息 ,布局 文件 修改 后 的 具体 设置 见 代 码 10.17. 

代码 1.17 Fragment 设置 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 


tools:context="cn.edu.uibe.cl0gmap.MapOneActivity"> 


<TextView 
android:id="@+id/locinfo" 
android:layout width="match parent" 
android:layout height="wrap content"/> 
<fragment xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:map="http://schemas.android.com/apk/res-auto" 
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xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/map" 
android:name="com.google.android.gms.maps.SupportMapFragment" 
android:layout width="match parent" 

android:layout height="match parent" 
tools:context="cn.edu.uibe.cl0gmap .MapOneActivity"/> 


</LinearLayout> 


除了 从 布局 文件 中 设置 MapFragment 的 方法 ,还 可 以 通过 编码 的 方式 在 Activity 中 
添加 一 个 MapFragment 对 象 。 使 用 这 种 方式 ,首选 要 创建 一 个 新 的 MapFragment 实例 ， 
然后 调用 FragmentTransaction. add() 方 法 将 Fragment 添加 到 当前 的 Activity 中 ,代码 
如 下 : 


mMapFragment=MapFragment .newInstance(); 
FragmentTransaction fragmentTransaction= 
getFragmentManager () .beginTransaction () 7 
fragmentTransaction.add(R.id.my container, mMapFragment); 
fragmentTransaction.commit () 7 


7. 绘制 形状 

可 以 使 用 Google Maps API for Android 在 地 图 上 添加 折线 、 多 边 形 和 圆 形 。 折 线 是 
一 系列 相连 的 线段 ,可 以 形成 任何 想 要 的 形状 ,可 以 用 来 标记 在 地 图 上 的 路 径 和 路 线 ; 多 
边 形 和 圆 形 都 是 一 个 封闭 的 形状 ,可 以 用 来 标记 在 地 图 上 的 地 区 。 它 们 都 有 着 相似 的 性 
能 ,并 允许 自 定义 线条 的 颜色 .宽度 等 。 

使 用 Polyline 类 在 地 图 上 定义 一 系列 连接 的 线段 。 一 个 Polyline 对 象 包括 了 一 系列 
LatLng 位 置 对 象 ,将 这 些 LatLng 对 象 按照 顺序 连接 起 来 就 形成 了 折线 。 要 创建 一 个 折 
线 ,首先 创建 一 个 PolylineOptions 的 对 象 ,然后 添加 位 置 点 。 位 置 点 代表 地 球 表面 上 的 
由 经 度 和 纬度 决定 的 一 个 点 ,定义 为 一 个 LatLng 对 象 。 将 这 些 点 添加 PolylineOptions 
对 象 中 ,线段 是 按照 点 与 点 之 间 的 顺序 绘制 而 成 。 要 添加 点 到 PolylineOptions 对 象 中 ， 
需要 调用 PolylineOptions. add() 方 法 。 可 以 连续 使 用 这 个 方法 一 次 添加 多 个 点 。 添 加 
折线 的 步骤 为 : 

(1) 实例 化 新 的 PolylineOptions 对 象 。 

(2) 设置 的 LatLng 对 象 ,用 PolylineOptions. add() 方 法 添加 点 。 

(3) 根据 需要 设置 其 他 属性 。 

(4) 调用 GoogleMap. addPolyLine 添加 一 个 折线 所 指定 的 地 图 PolylineOptions 。 

(5) 折线 显示 在 地 图 上 。 

在 地 图 上 定义 一 个 多 边 形 的 方法 与 定义 折线 是 相似 的 ,都 是 有 很 多 由 经 度 和 纬度 确 
定 的 位 置 点 组 成 的 ,但 多 边 形 是 封闭 的 ,而 折线 不 是 。 代 码 10. 18 示例 了 添加 一 个 长 方形 
在 地 图 上 的 一 段 代 码 。 
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代码 10.18 创建 形状 


//Instantiates a new Polyline object and adds points to define a rectangle 
PolylineOptions rectOptions=new PolylineOptions() 
.add (new LatLng(37.35,-122.0)) 
.add (new LatLng(37.45,-122.0)) //North of the previous point, but at the 
same longitude 
.add (new LatLng(37.45,-122.2)) //Same latitude, and 30km to the west 
.add (new LatLng (37.35,-122.2)) //Same longitude, and 16km to the south 
.add (new LatLng (37.35,-122.0)); //Closes the polyline. 


//Set the rectangle's color to red 


rectOptions.color (Color .RED); 


//Get back the mutable Polyline 
Polyline polyline=myMap.addPolyline (rectOptions); 


图 10.9 显示 了 代码 10. 18 运行 后 的 效果 。 
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图 10.9 运行 后 的 效果 


在 地 图 上 定义 圆 形 的 过 程 与 其 他 形状 有 所 不 同 ,需要 定义 两 个 属性 : 一 个 是 中 心 点 ， 
使 用 LatLng 表示 ; 另 一 个 是 半径 ,以 米 为 单位 。 

定义 的 圆 形 代表 地 球 表面 一 个 给 定 中 心 点 和 半径 所 确定 区 域 的 所 有 点 集合 。 由 于 实 
际 看 到 的 是 一 个 投影 ,如 果 半 径 比较 小 则 看 到 的 是 几乎 完美 的 圆 形 ,但 随 着 半径 的 增加 显 
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示 会 变 成 非 圆 形 。 

代码 10. 19 中 示例 了 添加 一 个 圆 形 的 代码 。 首 先 创建 一 个 CircleOptions 的 对 象 , 然 
后 调用 GoogleMap. addCircle(CircleOptions) 方 法 。 

代码 10.19 添加 圆 形 


//Instantiates a new Polygon object and adds points to define a rectangle 
CircleOptions circleOptions=new CircleOptions() 

.Center (new LatLng (37.4,-122.1)) 

„radius (1000)); //In meters 


//Get back the mutable Circle 
Circle circle=myMap.addCircle(circleOptions); 


圆 形 被 添加 后 ,如 果 要 改变 其 形状 ,可 以 调用 Circle. setRadius ) sk Circle. setCenter() 
办 法。 


10.3 本 章 小 结 


本 章 主要 介绍 了 Android 应 用 程序 如 何 使 用 实现 定位 服务 和 地 图 服务 。 

Android 通过 android. location 包 中 的 类 为 应 用 程序 提供 定位 服务 。 定 位 框架 中 的 
核心 组 件 就 是 LocationManager 系统 服务 ,其 提供 了 支撑 底层 设备 的 定位 API, Android 
设备 可 以 使 用 GPS 和 Android 网 络 位 置 提供 器 (Android Network Location Provider, 
NLP) 来 提供 位 置信 息 ,提供 与 位 置 相关 的 服务 。 

Android 应 用 程序 通过 调用 Google Maps Android API( 简 称 Maps API) 来 实现 基于 
Google Maps 的 地 图 服务 。Maps API 可 以 自动 处 理 对 Google Maps 服务 器 的 访问 、 数 
据 下 载 `. 地 图 显示 和 地 图 手势 的 事件 响应 。 在 Maps API 中 ,常用 的 重要 类 包括 
GoogleMap、MapFragment、MapView 和 Marker, Android 应 用 程序 在 使 用 Maps API 
之 前 ,需要 安装 Google Play services SDK ,获取 Maps API 密 钥 , 并 进行 menifest 文件 中 
的 密 钥 和 权限 设置 。 


Eclipse 的 Android App 开发 环境 


A.1 Android 开发 环境 搭建 


在 进行 Android 应 用 程序 开发 之 前 ,需要 搭建 Android 应 用 程序 开发 环境 。 在 本 书 
中 ,采用 开源 的 Java 集成 开发 环境 Eclipse 作为 开发 工具 ,并 添加 必需 的 Android SDK 和 
其 他 插件 。 

对 于 新 开发 者 来 说 ,Android 的 官方 网 站 http://developer. android. com 提供 了 包含 
Android SDK 的 Elipse 安装 包 链 接 ,开发 者 可 以 直接 从 链接 下 载 支持 Android 系统 的 
Eclipse 安装 包 。 但 这 里 还 分 别 介绍 了 安装 各 包 的 步骤, 以便 开发 者 学 习 。 按 照 Android 
开发 环境 的 安装 顺序 ,可 以 将 这 个 过 程 分 为 四 大 步 又， 

。 安装 Eclipse 开发 环境 ; 

。 安装 Android SDK; 

。 安装 Eclipse ADT 插件 ; 

。 安装 Google Play services SDK 。 

如 果 已 经 熟悉 Eclipse 开发 环境 的 安装 ,可 以 跳 过 A. 1 节 下 面 的 相关 内 容 , 直接 阅读 
A. 2 节 及 后 面 的 内 容 。 


A.1.1 安装 Eclispe 开发 环境 


Eclispe 开发 环境 的 安装 包括 安装 JDK、 下 载 和 安装 Eclipse 以 及 配置 Eclipse 三 个 
部 分 。 

了 DD 安装 JDK 

从 SUN 公司 发 布 的 JDK 的 官方 网 站 下 载 Windows 版 本 的 JDK 安装 软件 ,最 新 版 
本 为 JDK1.7。 

下 载 后 选 定 所 安装 的 磁盘 和 目录 ,判断 磁盘 空间 是 否 够 用 。 默 认 状 态 下 JDK 安装 在 
启动 盘 的 C:\Program Files\Java 目录 下 。 

运行 JDK 安装 包 , 根 据 安装 向 导 完成 JDK 的 安装 。 安 装 完成 后 ,在 Windows 中 进 
信行 命令 cmd 窗口 ,测试 安装 结果 。 

2) 下 载 和 安装 Eclipse 

从 Eclipse 官方 网 站 (http://www. eclipse. org/downloads/) 下 载 最 新 版 本 的 
Eclipse。 请 选择 Eclipse IDEforJavaEEDevelopers, 目 前 的 版 本 是 3.7.1. 

下 载 Eclipse 后 ,将 压缩 包 直 接 解压 到 硬盘 上 ,会 新 建 一 个 Eclipse 目录 存放 Eclipse 
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的 文件 。 假 设 解压 缩 到 D 盘 , 则 Eclipse 安装 在 D: Neclipse HRF. 
3) 配置 Eclipse 
进入 Eclipse, 首 先 看 到 欢迎 界面 。 关 闭 欢 迎 界面 ,可 以 看 到 默认 状态 下 Eclipse 平台 
的 各 个 视图 , 见 图 A. 1 。 
| wa EE - Eclipse 
File Edit Navigate Search Project Run Window Help 
-ar G+-@+ co7 Q g 


SD) Outi sz 


An outline is not available. 
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图 A.1 Eclipse 平台 视图 


选择 Window—- Preferences, #| JF Preferences 对 话 框 查看 Eclipse 的 选项 ,检查 JRE 
的 安装 是 否 正 确 ( 见 图 A. 2) ,同时 学 习 使 用 其 他 配置 项 。 


Installed JREs 


Add, remove or edit JRE definitions. By default, the check + 
added to the build path of newly created Java projects. 
Installed JREs: 
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图 A.2 检查 JRE 的 安装 


A.1.2 安装 Android SDK 


Eclipse 安装 完成 后 ,进行 Android SDK 安装 ,分 两 个 步骤。 
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(1) 下 载 Android SDK 安装 程序 。 

从 http://developer. android. com/sdk/index. html 下 载 最 新 的 安装 程序 ,并 安装 。 

(2) 添加 平台 和 其 他 组 件 。 

使 用 Android SDK Manager (该 工具 包含 在 SDK starter 包 中 ) 来 下 载 必要 的 SDK 
组 件 到 开发 环境 中 。 

如 果 使 用 的 是 Windows 安装 程序 , 它 会 在 安装 结束 后 自动 运行 Android SDK 
Manager( 见 图 A. 3) ,只 需要 接受 推荐 的 组 件 集 并 安装 就 可 以 了 。 当 然 也 可 以 手动 运行 
Android SDK Manager。 在 Linux 系统 中 ,打开 终端 并 进入 /tools 目录 ,然后 执行 
Android ,将 弹出 图 A. 3 所 示 界 面 ,在 界面 中 可 以 浏览 SDK repository 并 选择 新 的 或 更 新 
的 组 件 。 
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图 A.3 下 载 Android SDK 


A.1.3 安装 Eclipse ADT 插件 


在 Eclipse 环境 中 编写 Android 应 用 程序 ,通过 Android SDK 的 调用 ,可 以 直接 使 用 
Eclipse 进行 编译 。 但 Android 应 用 程序 最 终 运 行 在 手机 上 ,因此 需要 一 个 手机 的 模拟 运 
行 环境 来 测试 Android 应 用 程序 的 运行 状况 。 安 装 Eclipse ADT 插件 ,可 以 使 Eclipse Ji 
动 智能 手机 的 模拟 器 ,完成 在 Eclipse 上 的 Android 应 用 程序 模拟 运行 测试 。 

Eclipse ADT 插件 可 以 在 线 安装 ,也 可 以 下 载 到 本 地 手动 安装 。 

1) 下 载 ADT 插件 

(1) 启动 Eclipse, 选 择 Help—Install New Software, 

O) 单 击 右上 角 的 Add 按钮 。 

(3) 在 Add Repository 对 话 框 中 ,输入 名 称 ADT Plugin 以 及 如 下 地 址 : 


https://dl-ssl.google.com/android/eclipse/ 





附录 A_Ecipse 的 Android App 开发 环境 Nap 
— — 


注意 : 如 果 获 取 插 件 有 问题 ,使 用 http 协议 代替 https, 

(4) 在 Available Software 对 话 框 中 ,选中 Developer Tools 复 选 框 并 单 击 Next 
按钮 。 

(5) 在 下 一 个 窗口 中 ,将 看 到 一 系列 可 下 载 的 工具 , 单 击 Next 按钮 。 

(6) 阅读 并 接受 协议 , 单 击 Finish 按钮 。 

(7) 安装 完成 后 重启 Eclipse。 

2) 配置 ADT 插件 

(1) 选择 Window->Preferences。 

(2) 在 左 侧面 板 中 选择 Android 。 

(3) 在 主 面板 的 SDK Location 中 单 击 Browse 按钮 ,并 定位 到 所 下 载 的 SDK 目录 。 

(4) 单 击 Apply 按钮 ,然后 单 击 OK 按钮 。 

3) 下 载 本 地 并 手动 安装 

如 果 无 法 使 用 Eclipse F ADT 插件 ,可 以 下 载 ADT 的 zip 文件 到 本 地 并 手动 
安装 。 


A.1.4 安装 Google Play services SDK 


如 果 在 Android 应 用 系统 中 需要 用 到 地 图 等 功能 ,还 需要 安装 Google Play services 
SDK, Google Play services SDK 由 Android SDK 管理 器 安装 。 
(1) 启动 SDK 管理 器 。 从 Eclipse 启动 Android 的 SDK 管理 器 。 




















SDK Path: 
Packages 
* Name API Rev. Status 
v O D Extras | | 
Android Support Library | | 10 |# Update available: rev. 11 
(8 Google AdMob Ads SDK | 8 |$ Notinstalled 
Google Analytics SOK | | 2 |# notinstalled 
(@ Google Cloud Messaging for Android Library 3 |$ Notinstalled 
>” Google Play services 4 P notinstalled 
(B Google Play APK Expansion Library | | 2 [Š Notinstalled 
Ga Google Play Billing Library | | 3 |¥ Notinstalled 
(8 Google Play Licensing Library 2 |$ Notinstalled 
Ga Google USB Driver | | 7 |% Not compatible with Linux 
(8 Google Web Driver 2 |$ Notinstalled 
Ea Intel x86 Emulator Accelerator (HAXM) | | 2 |% Not compatible with Linux 
Show: W Updates/New Ü installed ([  Obsolete Select New or Updates Install 1 package... 
Sort by: @ API level Repository Deselect All Delete packages. 
Done loading packages. = 





图 A.4 下 载 安装 Google Play services SDK 


(2) 滚动 到 软件 包 列表 的 底部 ,选择 Extras>Google Play services, 并 安装 它 。 
(3) 在 使 用 Google Play services 的 相关 功能 时 ,将 目录 王 android-sdk-folder 二 / 
extras/ google/ google_play_services/libproject/google-play-services_lib 复制 到 Android 
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应 用 程序 项 目下 ,具体 的 操作 过 程 会 在 后 续 节 使 用 时 详细 说 明 。 


A.2 第 一 个 Android 应 用 程序 


在 完成 了 Android 开发 环境 的 安装 和 配置 后 ,就 可 以 使 用 Eclipse 开始 Android 应 用 
程序 了 。 下 面 介绍 第 一 个 Android 应 用 程序 。Hello Mobile World 的 开发 和 运行 过 程 ， 
它 的 功能 是 在 界面 上 显示 “您 好 ,移动 世界 ”的 字符 。 

第 一 次 编写 Android 应 用 程序 需要 完成 四 个 步骤 : 

步骤 一 : 创建 AVD。 

步骤 二 : 创建 一 个 新 的 Android MH. 

步骤 三 : 创建 用 户 界面 。 

步骤 四 : 运行 应 用 程序 。 


A.2.1 创建 AVD 


因为 Eclipse 运行 Android 应 用 程序 时 ,是 在 Android 仿真 器 中 运行 。 在 编写 和 运行 
Android 应 用 程序 之 前 ,第 一 步 必 须 先 创建 一 个 Android 虚拟 设备 ,也 就 是 Android 
Virtual Device( AVD)。AVD 定义 了 系统 镜像 以 及 仿真 器 需要 的 设备 设置 ,模拟 了 真实 
Android 系统 下 的 环境 。 

具体 的 操作 步骤 如 下 : 

(1) 在 Eclipse 中 ,选择 Window—> Android SDK and AVD Manager, 

(2) 在 左 侧 面板 中 选择 Virtual Devices, 

(3) 单 击 New 按钮 ,出现 Create new Android Virtual Device 对 话 框 ( 见 图 A.5) ,在 
对 话 框 中 对 AVD 的 名 称 、 软 件 环 境 和 硬件 属性 进行 配置 。 

在 Name 文本 框 中 输入 新 的 AVD 的 名 称 , 如 “my_avd”; 在 Target 下 拉 列 表 框 中 选 
择 AVD 所 使 用 的 Android SDK 版 本 。 如 果 在 Android SDK 安装 过 程 中 安装 了 几 个 版 
本 ,都 可 以 从 这 里 看 到 ;CPU/ABI 指示 的 是 模拟 器 运行 时 模拟 的 CPU 型 号 ;SD Card 的 
Size 输入 框 可 以 设 定 模 拟 器 的 内 存 大 小 ,例如 设置 为 512MB ;快照 Snapshot, 模拟 器 的 皮 
肤 Skin 和 硬件 配置 Hardware 可 以 采用 默认 值 。 

配置 完成 后 , 单 击 对 话 框 下 方 的 Create AVD 按钮 ,完成 AVD 的 创建 过 程 。 

(4) 选择 一 个 目标 。 目 标 即 是 想 在 仿真 器 上 运行 的 平台 (Android SDK 的 版 本 号 ,如 
2.1)。 可 以 忽略 剩 下 的 文本 框 。 

(5) 单 击 Create AVD 按钮 ,这 时 从 左面 列表 中 ,就 可 以 看 到 创建 好 的 AVD。 

AVD 前 面 的 复 选 框 处 于 选中 状态 ,表示 这 个 AVD 可 以 正常 运行 ,通过 右边 的 按钮 ， 
可 以 对 创建 好 的 AVD 进行 编辑 ,修复 等 操作 , 单 击 Start 按钮 可 以 直接 启动 AVD。 可 以 
创建 多 个 配置 不 同 的 AVD, 在 列表 中 单 击 相 应 的 AVD 后 ,直接 单 击 Start 按钮 运行 
该 AVD。 

(6) 关闭 AVD Manager 对 话 框 , 回 到 Eclipse 主 界面 。 























Override the existing AVD with the same name 








图 A.5 Create new Android Virtual Device 对 话 框 


A.2.2 创建 一 个 新 的 Android 项 目 


AVD 创建 完成 后 ,可 以 按照 创建 Eclipse 的 Java 或 Web 项 目 等 类 似 的 步骤 ,在 
Eclipse 中 创建 一 个 Android 项 目 。 


具体 的 操作 步骤 如 下 : 

(1) 在 Eclipse 中 ,选择 File>New->Project。 如 果 已 经 成 功 安装 ADT 插件 ,对 话 框 
中 将 出 现 一 个 名 为 Android 的 文件 夹 ,该 文件 夹 中 包含 Android Project( 在 创建 了 一 个 或 
多 个 Android 项 目 后 ,条 目 Android XML File 也 将 变 成 可 用 状态 ) 。 

(2) 选择 Android Project, 然 后 单 击 Next 按钮 。 

G) 在 对 话 框 中 填写 如 下 内 容 : 

e Project name; HelloWorld, 

e Application name: Hello, Mobile World! , 


e Package name: cn. edu. uibe. mc. sample( 或 者 你 自己 的 私有 命名 空间 ) 。 
e Create Activity: HelloWorldActivity。 


Project name 是 项 目 名 称 ,Eclipse 在 工作 区 中 创建 与 项 目 名 相同 的 目录 名 ,该 目录 
中 包含 项 目 文件 。 


Application name 是 应 用 程序 的 名 称 应 用 程序 的 标题 。 这 个 名 称 将 作为 应 用 程序 的 
标题 ,显示 在 Android 设备 上 , 这 是 给 用 户 的 提示 信息 。 这 里 给 该 应 用 取 名 为 Hello 
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Mobile World! 

Package name 是 Java 包 的 名 称 , 这 与 标准 Java 语言 中 包 的 概念 相同 。 在 此 包 中 ,将 
生成 主 Activity。 这 个 应 用 的 其 他 类 也 放 在 cn. edu. uibe. mc. sample 包 及 其 子 包 中 。 

Create Activity 是 主 Activity 的 类 名 称 ,是 Activity 类 的 子 类 。 一 个 Activity 就 是 一 
个 普通 的 类 , 它 能 创建 一 个 Android 用 户 界面 。 一 个 Activity 就 是 一 个 普通 的 类 , 它 能 创 
建 一 个 用 户 界 面 , 当然 这 并 不 是 必需 的 。 由 于 有 复 选 框 ,因此 创建 Activity 是 可 选 的 ,但 
是 Activity 通常 被 作为 一 个 应 用 程序 的 基础 。 这 里 输入 类 名 称 HelloWorldActivity。 

Min SDK Version 值 定义 了 应 用 程序 所 需要 的 最 小 API 等 级 。 更 多 信息 请 参考 
Android API Levels, 

Use default location 复 选 框 允许 改变 即将 生成 的 项 目 文件 在 磁盘 上 的 路 径 。 

Build Target 是 应 用 程序 将 被 编译 的 平台 目标 (基于 Min SDK Version, 该 值 将 被 自 
动 设置 )。 

注意 : 假如 已 经 选择 了 Android 1. 1 平台 作为 Build Target。 那 么 意味 着 应 用 程序 
将 在 Android 1.1 平台 库 基础 上 进行 编译 。 如 果 之 前 创建 的 AVD 运行 在 Android 1. 5 
平台 上 ,那么 没关系 ,Android 应 用 程序 是 向 前 兼容 的 ,因此 在 1. 1 平台 库 上 构建 的 应 用 
程序 可 以 正常 运行 在 1.5 平台 上 ,反之 则 不 行 。 

(4) 单 击 Finish 按钮 。 

完成 Android 项 目的 创建 之 后 ,就 可 以 在 这 个 项 目 中 对 Android 用 户 界 面 进行 定义 
和 修改 了 。 

从 左面 的 Package Explorer 视图 中 ,可 以 看 到 前 面 所 建 的 Hello 项 目 , 单 击 打 开 , 查 
看 src 目录 下 的 cn. edu. uibe. mc. sample 下 的 Java 源 程 序 HelloWorldActivity. java。 打 
开 该 Java 源 文件 ,其 内 容 见 代码 A. 1。 

代码 A.1 HelloWorldActivity. java 


import android.app.Activity; 
import android.os.Bundle; 


public class HelloWorldActivity extends Activity { 

/** Called when the activity is first created. * / 

@override 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 


| 


从 代码 A. 1 中 可 以 看 出 HelloWorldActivity 是 Activity 的 子 类 。Activity 是 
Android 系统 中 用 于 实现 用 户 图 形 界面 的 类 。 

public void onCreate() 方 法 是 Activity 所 定义 的 方法 , 当 Activity 启动 时 由 Android 
系统 调用 ,会 首先 在 这 个 方法 中 执行 初始 化 和 用 户 界面 设置 工作 。 
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一 个 Activity 并 不 一 定 要 有 用 户 界面 ,但 通常 都 会 有 有 。Activity 概念 可 以 参照 Java 
中 的 Applet 概念 来 理解 。 


A23 创建 用 户 界面 


如 果 要 在 Android 界面 上 显示 “您 好 ,移动 世界 ”, 需要 对 自动 生成 的 
HelloWorldActivity. java 代码 进行 修改 ,在 onCreate() 方 法 中 添加 显示 字符 串 的 组 件 ,并 
设置 其 显示 出 来 , 见 代 码 A.2。 

代码 A.2 修改 后 HelloWorldActivity. java 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class HelloWorldActivity extends Activity { 
/xx Called when the activity is first created. * / 
@override 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
TextView tv=new TextView(this); 
tv.setText ("您 好 ,移动 世界 1"); 


setContentView (tv); 


} 


在 Java 程序 导 入 包 的 时 候 ,可 以 直接 使 用 快捷 键 Ctrl 十 Shift 十 O。 

在 代码 A. 2 中 定义 了 一 个 文本 显示 框 TextView 的 对 象 tv, 将 TextView 类 对 象 作 
为 Activity 用 户 界面 显示 的 内 容 , 传 给 setContentView () 方 法 。Activity 通过 调用 
setContentView(tv) ,把 tv 的 内 容 显示 出 来 。 如 果 Activity 不 调用 setContentView() 方 
法 , 则 不 会 显示 任何 用 户 界面 ,系统 会 显示 一 片 空白 。 

下 一 步 , 就 是 运行 应 用 程序 了 。 


A.2.4 运行 应 用 程序 


在 仿真 器 中 运行 HelloWorldActivity 的 步骤 如 下 : 

(1) 在 Eclipse 中 ,选择 Run—Run, 

(2) 选择 Android Application, Eclipse 插件 自动 为 应 用 程序 创建 一 个 新 的 运行 配置 
并 启动 Android 仿真 器 。 

(3) 当 仿 真 器 启动 后 ,Eclipse 插件 将 安装 应 用 程序 并 运行 默认 的 Activity, 

启动 仿真 器 后 ,可 以 看 到 一 个 手机 的 界面 。 左面 是 显示 屏幕 ,右边 是 手机 的 键盘 按 
键 ,通过 键盘 的 按钮 可 以 直接 对 仿真 器 进行 操作 。 

这 时 需要 真正 耐心 等 待 运行 结果 。 一 般 来 说 ,第 一 次 在 仿真 器 上 运行 Android 应 用 
程序 需要 花 更 长 的 时 间 。 具 体 的 时 间 与 机 器 的 性 能 和 配置 有 关 。 
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如 果 5~ 6min 都 只 看 到 仿真 器 上 的 logo 在 闪烁 ,不 要 着 急 , 去 休息 一 下 ,过 一 会 儿 
再 来 。 

图 A. 6 是 修改 后 HelloWorldActivity. java 的 运行 结果 。 上 面 一 行文 字 是 前 面 定义 
的 Application name; 下 面 一 行 是 Text View 对 象 显示 的 内 容 。 


[EE ETT] 











Hello, Mobile World 


图 A.6 AVD 运行 结果 


单 击 右面 键盘 上 的 返回 键 ,返回 Android 系统 的 主 界面 , 见 图 A. 7。 





图 A.7 Android 系统 的 主 界面 
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这 是 Android 系统 的 主 界面 ,除了 刚才 编写 的 程序 外 ,还 有 一 些 其 他 的 程序 ,例如 时 
钟 日 历 . 照 相机 、 图 片 等 ,这 些 程序 是 创建 Android 项 目 时 ,由 Android SDK 加 载 的 
Demo 程序 。 

选择 任意 一 个 logo, 如 选择 API Demos— animation, Ji 3JJ Android 系统 的 应 用 程序 ， 
查看 结果 。 

单 击 右面 键盘 上 的 Home 键 , 回 到 主 界面 , 单 击 图 A. 7 中 左下 角 的 白 底 绿 小 机 器 人 
(这 是 应 用 程序 的 logo) ,可 以 重新 看 到 图 A. 6 的 显示 结果 。 

图 A.6 中 的 “Hello Mobile World” 的 界面 中 ,灰色 条 显示 的 “Hello, Mobile World” 
就 是 应 用 程序 标题 ,该 字符 串 定 义 在 res/values/strings. xml 文件 中 并 被 
AndroidManifest. xml 文件 所 引用 ,标题 之 下 的 文本 就 是 Java 源 程序 在 TextView 对 象 
中 设置 的 。 

这 里 使 用 的 是 编程 式 的 用 户 布局 方式 ,也 就 是 使 用 Java 程序 来 定义 用 户 界面 上 的 
View 图 形 组 件 。 这 种 布局 方式 有 很 大 的 缺点 ,如 一 些小 的 布局 变化 有 可 能 导致 大 的 源码 
修改 ,编写 程序 时 也 很 容易 忘记 将 多 个 View 链接 在 一 起 。 

以 上 就 是 构建 “Hello, Mobile World” 应 用 程序 的 过 程 ,但 这 不 是 Android 系统 推荐 
的 设计 用 户 界 面 的 方法 ,Android 提供 了 一 个 可 选 的 用 户 界 面 构 建 模型 : 基于 XML 的 布 
局 文件 的 用 户 界面 构建 模型 。 

下 面 介绍 如 何 使 用 XML 布局 文件 来 构建 用 户 界面 。 


A.2.5 使 用 XML 来 定义 用 户 界面 


刚才 完成 的 “Hello,Mobile World” 应 用 程序 使 用 的 是 编程 式 的 用 户 布 局 方式 。 使 用 
这 种 方式 是 直接 在 源 代码 中 构建 应 用 程序 的 用 户 界面 。 这 种 方式 对 于 界面 的 开发 是 很 不 
方便 的 ,因为 一 些小 的 布局 变化 都 有 可 能 导致 源码 的 修改 ,并 且 需 要 重新 编译 ,所 以 我 们 
需要 使 用 MVC 开发 模式 。Android 也 设计 了 一 套 MVC 开发 模式 ,其 提供 了 一 个 基于 
XML 的 布局 文件 来 定义 用 户 界面 。 

Android 系统 推荐 使 用 XML 布局 文件 来 设计 用 户 界面 。XML 布局 文件 都 位 于 应 
用 程序 的 res/layout/ 目录 中 。res 是 resources 的 缩写 ,该 目录 中 包含 应 用 程序 所 需要 的 
所 有 非 代 码 资源 。 除 了 布局 文件 之 外 ,资源 还 包括 图 片 .声音 以 及 本 地 字符 串 。 

在 Package Explorer 中 ,展开 res/layout/ 文 件 夹 。 在 创建 Android 项 目 时 ,Eclipse 
插件 自动 创建 一 个 布局 文件 : main. xml。 在 前 面 修改 完成 的 “Hello Mobile World” 应 用 
中 ,该 文件 被 忽略 了 ,而 以 编程 的 方式 创建 了 布局 。 这 是 为 了 介绍 更 多 关于 Android 框架 
知识 。 通 常情 况 下 ,建议 使 用 XML 文件 布局 而 不 是 硬 编码 。 

双击 打开 main. xml 文件 , 单 击 Java 视图 里 的 main. xml 小 标签 ,XML 文件 内 容 见 
代码 A.3。 

代码 A.3 main. xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/ 
android" 
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android:layout width="fill parent" 
android:layout height="fill parent" 


android:orientation="vertical"> 


<TextView 
android:layout width="fill _ Parent" 
android:layout_height="wrap_content" 
android:text="@string/hello" /> 


</LinearLayout> 


— Android XML 布局 文件 的 总 体 结构 比较 简单 : 就 是 一 棵 XML 元 素 的 树 , 树 中 
的 每 个 节点 都 使 用 View 类 的 类 名 作为 元 素 名 称 , 每 一 个 元 素 都 对 应 一 个 用 户 图 形 界面 
中 的 组 件 , 在 代码 A. 3 中 只 有 一 个 元 素 TextView。 

XML 布局 中 的 元 素 可 以 是 任何 View 子 类 ,包括 自 定义 的 View 类 。 与 编程 布局 方 
式 相 比 ,XML 布局 使 用 了 更 简单 的 结构 和 语法 ,能 够 快速 构建 用 户 界面 。 这 种 模型 的 灵 
感 源 于 Web 开发 模型 ,使 用 这 种 方式 ,把 应 用 程序 的 用 户 界面 从 应 用 逻辑 中 分 离 了 出 来 。 
仔细 查看 代码 A. 3 内 容 ,初步 了 解 XML 布局 的 语法 格式 。 

<?xml version= "1. 0"”encoding 王 "utf-8"? 过 是 版 本 和 采用 的 编码 标准 ,这 是 布局 
类 型 定义 。 在 这 个 XML 布局 文件 中 ,只 定义 了 一 个 View 元 素 : TextView, 它 有 4 个 
XML 属性 ,分 别 在 下 面 进行 了 定义 : 

。 xmlns:android。 这 是 XML 命名 空间 声明 , 它 告 诉 Android 工具 应 用 程序 将 要 引 
用 在 Android 命名 空间 中 定义 的 普通 属性 。 在 每 个 Android 布局 文件 的 最 外 层 
标签 中 必须 包含 这 个 属性 。 
android:layout_width。 定 义 了 TextView 在 屏幕 上 会 占用 的 可 用 宽度 。 在 本 例 
中 ,由 于 只 有 一 个 View, 这 里 设置 它 占据 整个 屏幕 ,因此 定义 了 值 fill_parent。 
android:layout_height。 定 义 了 TextView 在 屏幕 上 会 占用 的 可 用 高 度 。 属 性 值 
和 android:layout_width 相似 。 
android:text。 设 置 了 TextView 将 要 显示 的 值 。 在 本 例 中 ,使 用 了 字符 串 资源 而 
不 是 直接 给 出 了 字符 串 值 。 字 符 串 定义 在 res/values/strings. xml 文件 中 。 这 是 
一 种 推荐 的 方式 ,因为 这 可 以 使 应 用 程序 能 够 很 好 地 本 地 化 ,而 不 需要 改变 布局 
文件 。 

下 面 修改 程序 代码 ,使 这 个 hello 程序 采用 XML 布局 文件 定义 用 户 界面 。 

1) 定义 XML 布局 文件 

在 Eclipse 的 Package Explorer 中 ,展开 res/layout/ 文 件 夹 并 打开 main. xml 文件 ， 
查看 里 面 的 组 件 定义 是 否 符合 要 求 , 这 里 还 是 沿用 原来 的 main. xml。 

如 果 在 项 目 中 有 多 个 Activity, 需 要 使 用 不 同 的 界面 布局 ,可 以 在 res/layout/ 目 录 下 
创建 新 的 布局 文件 。 
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2) 在 资源 文件 string. xml 中 定义 字符 串 变 量 的 值 

进入 res/values/ 文 件 夹 , 打 开 strings. xml 文件 ,这 是 用 户 界 面 保存 所 有 默认 字符 串 
的 文件 。 前 面 使 用 Eclipse 工具 创建 Android 项 目 时 ,ADT 已 经 根据 创建 Android 项 目 
时 输入 的 信息 , 设 定好 两 个 字符 串 变量 hello 和 app_name 的 值 ,分 别 为 “你 好 ,移动 世 
界 1!” 和 “Hello Mobile World!”, 见 代码 A. 4。 

代码 A.4 string. xml 


<?xml version="1.0" encoding="utf-8"?> 


<resources> 


<string name="hello"> 你 好 ,移动 世界 !< /string> 
<string name="app_name">Hello Mobile World !</string> 


</resources> 


3) 修改 HelloWorldActivity. java 文件 
恢复 HelloWorldActivity. java 原来 没有 定义 Text View 时 的 代码 : 


setContentView(R.layout.main); 


原来 传递 给 setContentView () 方 法 的 是 一 个 View 对 象 ,现在 传递 的 是 标识 为 
R. layout. main 的 布局 资源 引用 。R. layout. main 实际 上 是 一 个 编译 好 的 对 象 ,也 就 是 在 
/res/layout/main. xml 文件 中 的 布局 定义 。Eclipse 插件 自动 在 项 目的 R. java 类 中 创建 
了 这 个 引用 。 

重新 运行 HelloWorldActivity. java 文件 ( 见 代码 A.5) ,查看 AVD 上 的 结果 。 

代码 A.5 HelloWorldActivity. java 


import android.app.Activity; 

import android.os.Bundle; 

public class HelloWorldActivity extends Activity ( 
/xx Called when the activity is first created. * / 
@override 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 

1 

) 


运行 代码 A. 5 后 ,显示 的 结果 与 前 面 使 用 编程 式 布 局 定义 没有 什么 不 同 。 下 面 修改 
一 下 main. xml 文件 ,添加 一 个 TextView 定义 ,看 看 main. xml 文件 如 何 对 应 用 程序 布局 
的 影响 。 

4) 修改 main. xml 文件 

先 把 XML 文件 中 原来 的 TextView 定义 复制 一 份 , 放 在 它 的 下 面 。 由 于 添加 一 个 








基于 Android 平台 的 移动 互联 网 应 用 开发 (第 版 ) 





TextView, 要 识别 不 同 的 TextView 对 象 ,需要 添加 一 条 语句 : 
android:id="@+id/textviewl" 


android :;id 属性 给 TextView 元 素 分 配 了 一 个 唯一 的 标识 textview1。 可 以 使 用 这 个 
标识 在 Java 源 代 码 或 者 其 他 XML 资源 声明 中 引用 这 个 对 象 。 给 这 两 个 TextView 的 标 
识 分 别 设置 为 textview1 和 textview2, 见 代码 A. 6。 

代码 A.6 修改 后 的 main. xml 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 

android:layout height="fill parent" 


android:orientation="vertical"> 


<TextView 
android:id="@+id/textviewl" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="@string/hello" /> 
<TextView 
android:id="@+id/textview2" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="@string/hello" /> 
</LinearLayout> 


保存 main. xml 文件 。 再 次 运行 HelloWorldActivity. java 文件 ,查看 AVD 界面 , 结 
果 显 示 了 两 行 的 字符 ,每 一 行 是 一 个 TextView。 

5) 修改 资源 文件 

进入 res/values/ 文 件 夹 ,打开 strings. xml 文件 ,这 是 Android 为 用 户 界 面 保 存 所 有 
默认 字符 串 的 地 方 ,找到 string 的 定义 ,这 里 的 值 就 是 显示 在 屏幕 上 的 字符 串 。 

在 string 下 面 定义 一 个 新 的 字符 串 newhello, 赋值 为 “你 好 , Android 移动 商务 平 
台 !”。 保 存 strings. xml 文件 。 


<string name="newhello"> 你 好 , Android 移动 商务 平台 ! </string> 


6) 修改 main. xml 文件 
修改 textview1 的 text 为 newhello ,让 textview2 显示 newhello 定义 的 字符 串 ,保存 
main. xml 文件 。 代 码 如 下 : 


<TextView 
android:id="@+id/textview2" 
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android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="@string/newhello" /> 


再 次 运行 HelloWorldActivity. java 文件 , AVD 上 的 结果 显示 了 三 行 字符 :“Hello 
Mobile World”“ 你 好 ,移动 世界 1!” 和 “你 好 ,Android 移动 商务 平台 !”。 

7) 查看 apk 文件 

到 这 里 ,就 完成 了 第 一 个 Android 应 用 程序 的 开发 和 运行 ,也 得 到 了 可 以 在 真正 
Android 系统 上 运行 的 apk 文件 。 

展开 hello 项 目 中 的 bin 目录 ,可 以 看 到 hello. apk 文件 ,在 手机 上 像 安 装 其 他 
Android 程序 一 样 安装 hello. apk 文件 后 ,在 Android 的 应 用 程序 目录 下 找到 hello 的 项 
目 图 标 ,就 可 以 运行 了 。 

在 仿真 器 上 调试 通过 后 ,apk 文件 发 布 到 支持 相应 Android SDK 版 本 的 手机 上 可 以 
直接 运行 ,不 必 再 针对 具体 的 型 号 进行 调试 ,开发 者 只 需要 做 到 这 一 步 就 完成 了 Android 
应 用 程序 的 开发 。 


A.3 Android 项 目 结构 分 析 


A.2 节 中 创建 了 第 一 个 Android 项 目 , 下 面 以 这 个 应 用 为 基础 进行 目录 结构 概述 ( 见 
图 A. 8)。 


[ë package ploreca ag 








a (Š HelloWorld 
2 @ src 
2 EB cn.class3g.activity 
> D HelloWorldActivityjava 
4 吕 gen [Generated Java Files] 
< EB cndass3g.activity 
> D Rjava 
a mà Android 2.1 
b Ë androidjar - F\androidStudy\and 
Ë assets 
> @ bin 
a D res 
4 © drawable-hdpi 
qü ic_launcher.png 
4 © drawable-Idpi 
qü ic_launcher.png 
4 © drawable-mdpi 
qü ic_launcher.png 
á © layout 
国 mainxml 





a © values 

B stringsxml 
B AndroidManifestxml 
B proguard.cfg 
B projectproperties 





图 A.8 Android 项 目 目录 结构 
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任何 Android 项 目 创建 后 ,都 会 自动 生成 图 A. 8 所 示 的 目录 。 下 面 简单 介绍 这 些 目 


录 所 包含 的 内 容 和 作用 。 
1) src 文件 夹 
与 一 般 的 Java 项 目 一 样 sre 文件 夹 是 项 目的 所 有 包 及 源 文件 (.java) 。 
2) gen 文件 夹 


该 目录 下 的 所 有 文件 都 不 是 由 开发 人 员 创 建 的 ,而 是 由 ADT 自动 生成 的 。 其 中 ,R. 
java 文件 是 定义 该 项 目 所 有 的 资源 文件 的 索引 文件 ,该 文件 是 只 读 模 式 。R. java 文件 中 
默认 有 attr.drawable.layout.string 四 个 静态 内 部 类 ,其 内 容 见 代码 A.7。 

代码 A.7 R.java 


public final classR { 
public static final class attr { 
i 
public static final class drawable { 
public static final int ic_launcher=0x7f020000; 
} 
public static final class layout { 
public static final int main=0x7f030000; 
i; 
public static final class string ( 
public static final int app_name=0x7f040001; 
public static final int hello=0x7f040000; 


} 


3) Android2.1 

它 包 含 了 android.jar 包 ,是 Android SDK 中 提供 Android platforms API 的 基本 类 
f, Android 库 、 系 统 镜像 .样本 代码 、 仿 真 skins (界面 ) 以 及 指定 版 本 的 工具 。 这 是 
Android 应 用 程序 运行 的 基础 支持 。 

4) assets 文件 夹 

Android 系统 为 每 个 新 设计 的 程序 提供 了 /assets 目录 ,这 个 目录 保存 的 文件 可 以 打 
包 在 程序 里 。/res 和 /assets 的 不 同 点 是 ,android 不 为 /assets 下 的 文件 生成 ID。 如 果 使 
用 /assets 下 的 文件 ,需要 指定 文件 的 路 径 和 文件 名 。 

5) bin 文件 夹 

它 是 程序 自动 生成 的 应 用 文件 夹 ,用 来 存放 项 目 中 应 用 程序 生成 的 apk 文件 。 

6) res 文件 夹 

该 目录 为 资源 目录 ,而 res 就 是 resources 的 缩写 。 该 目录 用 来 存放 图 标 、 界 面 文件 
和 应 用 中 用 到 的 文字 信息 。 这 个 目录 中 又 有 专门 的 子 目 录 存 放 特 定 资源 ,其 中 : 

(1) res/ 目 录 下 的 三 个 drawable 文件 夹 。 

这 三 个 目录 的 区 别 只 是 将 图 标 按 分 辨 率 高 低 来 存放 入 不 同 的 目录 中 ,其 中 drawable- 
hdpi 用 来 存放 高 分 辨 率 图 标 ;drawable-mdpi 用 来 存放 中 等 分 辩 率 图 标 ; drawable-ldpi 用 
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来 存放 低 分 辩 率 图 标 。 

(2) res/values/ 。 

该 目录 用 来 存放 strings. xml 等 类 似 于 定义 属性 值 的 资源 文件 。 

strings. xml 用 来 定义 字符 串 和 数值 ,HelloWorld 项 目 中 的 strings. xml 文件 内 容 
如 下 : 


<?xml version="1.0" encoding="utf-8" > 

<resources> 
<string name="hello">Hello World World, HelloWorldActivity!</string> 
<string name="app name">HelloWorld</string> 

</resources> 


其 中 ,string 标签 声明 一 个 字符 串 ,name 属性 指定 其 引用 名 。 把 应 用 中 出 现 的 文字 
单独 存放 在 strings. xml 文中 的 原因 有 两 个 : 一 是 为 了 国际 化 ;二 是 为 了 减少 应 用 体积 ， 
降低 数据 宛 余 。 

(3) res/layout/ 。 

该 目录 用 来 存放 布局 文件 。main. xml 布局 文件 是 Android 项 目 生成 时 自动 产生 的 
主 界面 布局 文件 ,程序 员 可 以 根据 自己 的 界面 设计 ,定义 命名 自己 的 布局 文件 。 

7) 根 目录 下 的 三 个 重要 文件 

AndroidManifest. xml 文件 : 包含 了 该 Android 项 目 中 所 有 使 用 的 Activity. 
Service Receiver 等 组 件 的 声明 。 

default. properties 文件 : 记录 项 目 中 所 需要 的 环境 信息 ,如 Android 的 版 本 等 。 

proguard. cfg 文件 : 混淆 代码 的 脚本 配置 文件 。 


Ed 
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